Nginx框架是围绕着ngx_cycle_t结构体来控制进程运行的。ngx_cycle_t结构体的prefix、conf_prefix、conf_file等字符串类型成员保存着Nginx配置文件的路径。Nginx在程序运行的时候会使用ngx_init_cycle方法来根据nginx.conf加载模块。
ngx_cycle_t结构体定义:
struct ngx_cycle_s {
void ****conf_ctx;
/* 保存着所有模块存储配置项的结构体的指针,它首先是一个数组,每个数组成员又是一个指针,
这个指针指向另一个存储着指针的数组 */
ngx_pool_t *pool;
/* 内存池 */
ngx_log_t *log;
ngx_log_t new_log;
/* 日志模块中提供了生成基本ngx_log_t日志对象的功能,
这里的log实际上是在还没有执行ngx_init_cycle方法前,如果有信息需要输出到日志,
就会暂时使用log对象,它会输出到屏幕。
* 在ngx_init_cycle方法执行后,将会根据nginx.conf配置文件中的配置项,构造出正确的日志文件,
此时会对log重新赋值(用new_log的地址覆盖上面的log指针)
*/
ngx_uint_t log_use_stderr;
/* unsigned log_use_stderr:1; */
ngx_uint_t files_n;
ngx_connection_t **files;
/* 对于poll、rtsig这样的事件模块,会以有效文件句柄数来预先建立这些ngx_connection_t结构体,
以加速事件的收集、分发。这时files就会保存所有ngx_connection_t的指针组成的数组,files_n是指针的总数。*/
ngx_connection_t *free_connections;
ngx_uint_t free_connection_n;
/* 空闲连接池,与free_connection_n配合使用 */
ngx_queue_t reusable_connections_queue;
/* 可重复使用的双向连接队列,成员类型是ngx_connection_t */
ngx_array_t listening;
/* 动态数组,表示监听端口及相关参数 */
ngx_array_t paths;
/* 保存Nginx要操作的所有目录,如果目录不存在,则会试图创建,而创建目录失败将导致Nginx启动失败。*/
ngx_list_t open_files;
/* 保存Nginx已经打开的所有文件,类型是ngx_open_file_t,Nginx不会主动添加文件,这是给模块自己用的,
如果需要的话,模块向其中添加文件路径名,Nginx框架会在ngx_init_cycle方法中打开这些文件 */
ngx_list_t shared_memory;
/* 单链表存储ngx_shm_zone_t,每个元素表示一块共享内存。*/
ngx_uint_t connection_n;
ngx_connection_t *connections;
ngx_event_t *read_events;
ngx_event_t *write_events;
/* 表示当前进程中所有的连接对象和它们的读写事件,connection_n是它们的数量 */
ngx_cycle_t *old_cycle;
/* 旧的ngx_cycle_t对象用于引用上一个ngx_cycle_t对象中的成员,例如ngx_init_cycle方法,
在启动初期,需要建立一个临时的ngx_cycle_t对象保存一些变量,在调用ngx_init_cycle方法时,
就可以把旧的ngx_cycle_t的对象传进去,而这时old_clcle对象就会保存这个前期的ngx_clcle_t对象。*/
ngx_str_t conf_file;
/* 配置文件相对于安装目录的路径名 */
ngx_str_t conf_param;
/* nginx处理配置文件时需要特殊处理的在命令行携带的参数,一般是-g选项携带的参数 */
ngx_str_t conf_prefix;
ngx_str_t prefix;
/* Nginx配置文件所在目录的路径和安装目录的路径 */
ngx_str_t lock_file;
/* 用于进程间同步的文件锁名称 */
ngx_str_t hostname;
/* 使用gethostname系统调用得到的主机名 */
};