高性能Web服务器Nginx的配置与部署研究（7）核心模块之主模块的非测试常用指令

1. error_log

含义：指定存储错误日志的文件

语法：error_log <file> [debug|info|notice|warn|error|crit]

缺省：${prefix}/logs/error_log

示例：error_log file debug;

注意：在编译Nginx使用--with-debug参数，则可以参考《高性能Web服务器Nginx的配置与部署研究——（6）Nginx核心模块的测试常用指令》中的error_log部分

2. include

含义：指定所要包含的Nginx配置文件

语法：include <file|*>

缺省：none

示例：include vhosts/*.conf 或 include /home/michael/nginx/conf/nginx-main.conf

注意：

（1）include命令可以指定包含一个文件，比如第二个示例。也可以指定包含一个目录下的所有文件，比如第一个示例。

（2）指定的文件路径的基路径，由编译选项--prefix决定，如果编译时没有指定，则默认的路径是/usr/local/nginx。

3. lock_file

含义：

语法：lock_file <file>

缺省：compile-time option

示例：lock_file /var/log/lock_file;

注意：Nginx使用accept
mutex来序列化accept()系统调用（syscalls）。如果是在i386，sparc64，ppc64或amd64平台上用
GCC，Intel C++，SunPro C++编译器编译的，则Nginx使用CPU原指令实现mutex。其他情况下，则使用lock_file。

4. pid

含义：指定存储进程ID（即PID）的文件。

语法：pid <file>

缺省：compile-time option Example

示例：pid /var/log/nginx.pid;

注意：可以使用命令kill -HUP cat /var/log/nginx.pid\ 对Nginx进行进程ID文件的重新加载。

本文欢迎转载，转载必须注明出处：http://blog.csdn.net/poechant

5. ssl_engine

含义：指定使用的openssl引擎。

语法：ssl_engine engine;

缺省：视系统而定

示例：

注意：你可以使用openssl engine -t命令来查看系统目前支持的openssl引擎。

6. timer_resolution

略

7. user

含义：指定可以使用Nginx的用户

语法：user <user> [group]

缺省：nobody nobody（第一个nobody是user，第二个nobody是group）

示例：user www users;

8. worker_processes

含义：指定worker进程数

语法：worker_processes <number>

缺省：1

示例：worker_processes 4;

注意：最大用户连接数=worker进程数×worker连接数，即max_clients=worker_processes*worker_connections。

9. worker_cpu_affinity

含义：为worker进程绑定CPU。

语法：worker_cpu_affinity cpumask [cpumask...]

缺省：none

示例：

（1）如果有4个CPU，并且指定4个worker进程，则：

worker_processes 4;

worker_cpu_affinity 0001 0010 0100 1000;

（2）如果有4个CPU，并且指定2个worker进程，则：

worker_processes 2;

worker_cpu_affinity 0101 1010;

注意：只有Linux平台上才可以使用该指令。

10. worker_priority

含义：指定各worker进程的优先级

语法：worker_priority [-] <number>;

缺省：on

示例：

注意：使用该指令可以给woker进程分配优先值。

11. worker_rlimit_core

含义：指定每个worker进程的core文件最大size。

语法：worker_rlimit_core <max_size>;

12. worker_rlimit_nofile

含义：worker进程的file descriptor可以打开的最大文件数。

语法：worker_rlimit_nofile <number>;

13. worker_rlimit_sigpending

略

14. working_directory

含义：指定worker进程的core文件目录。

语法：working_directory <path>

缺省：编译Nginx时的--prefix选项指定的目录

示例：working_directory /data/nginx/data;

注意：如果是相对路径，则以编译Nginx时的--prefix选项为基路径。