Nginx API 学习之三：配置文件中数据设置单位和命令行参数

目录

• 配置文件中数据设置单位
• 命令行参数

Configuration file measurement units (nginx.org)

Command-line parameters (nginx.org)

配置文件中数据设置单位

大小单位可以指定为 bytes、kilobytes（后缀为 k 或 K）和 megabytes（后缀为 m 或 M），例如 “1024”、“8k” 和 “1m”。

偏移量还可以指定为 gigabytes，后缀为 g 或 G。

间隔可以指定为 毫秒、秒、分、时和天等，后缀对应关系如下：

• ms：毫秒
• s：秒
• m：分
• h：时
• d：天
• w：周
• M：月，30天
• y：年，365天

多个单位按从多到少顺序组合成一个简单的值，空格区分，例如 “1h 30m” 指定相同的时间 “90m” 或 “5400s”。没有后缀的时间含义是秒，建议带后缀。

有些时间间隔只可以设置为秒值。

命令行参数

nginx支持以下命令行参数：

• -? | -h # 打印帮助说明
• -c file # 用配置文件 file 替换默认配置文件
• -e file # 用替换的错误日志文件 file 替换默认文件（1.19.5），用特殊参数 stderr 选择标准错误文件
• -g directives # 设置 global configuration directives，例如：

nginx -g "pid /var/run/nginx.pid; worker_possesses `sysctl -n hw.ncpu`;"

• -p prefix # 设置 nginx 目录前缀，例如：保存服务器文件目录（默认值是 /usr/local/nginx）

• -q # 配置测试过程中抑制非错误消息

• -s signal # 发送信号到主进程。signal 参数可以是：

  • stop # 快速关闭
  • quit # 从容关闭
  • reload # 重载配置文件，依据新配置文件启动新工作进程，从容关闭旧工作进程。
  • reopen # 重新打开日志文件

• -t # 测试配置文件：核查配置文件语法正确性，然后试着启用新配置

• -T # 通 -t，增加转储配置文件到标准输出（1.9.2）

• -v # 打印 nginx 版本

• -V # 打印 nginx 版本、编译器版本和配置参数