框架代码分析

核心模块

启动过程（main）

1、全局ngx_cycle_t对象

1、ngx_init_cycle

2、cycle->listening对象数组（ngx_listening_t对象数组）

2、cycle->conf_ctx指针数组

2、各个CORE模块create_conf创建配置对象，赋值给conf_ctx指针数组

2、ngx_conf_parse解析所有配置文件到conf_ctx指针数组

2、各个CORE模块init_conf配置缺省默认值

2、ngx_open_listening_sockets监听端口（数据来源：listening对象数组）

2、所有模块init_module过程

1、ngx_single_process_cycle

2、所有模块init_process过程

2、死循环处理事件：ngx_process_events

P.S. http{}解析完，会调用ngx_core_listen_parse将端口信息拷贝到listening对象数组，设置处理函数为ngx_http_init_connection（tcp建链完成后的处理函数入口）

配置解析功能（ngx_conf_parse）

（1）如核心模块中user、group配置（core模块）

conf_ctx指针数组中指针直接指向配置对象

（2）如events{}中multi_accept配置（event_core模块）、events配置（epoll模块）

conf_ctx指针数组中指针指向指针A，指针A指向配置对象指针数组（数组个数为event模块数，指针数组中各指针指向各event模块特有的配置对象）

（3）如https{}中配置（event_core模块）、events配置（epoll模块）

conf_ctx指针数组中指针指向根ngx_http_conf_ctx_t对象，每个{}信息存储在独立的ngx_http_conf_ctx_t对象中，通过链表进行级联）

1、ngx_events_block

1、指针对象、指针数组

1、所有event模块的create_conf过程

1、ngx_conf_parse嵌套解析events{}中的配置信息

1、所有event模块的init_conf过程

2、ngx_http_block

1、根ngx_http_conf_ctx_t对象、三个成员指向三个指针数组

1、所有http模块的pre_conf过程

1、所有http模块的create_main_conf过程

1、所有http模块的create_srv_conf过程

1、所有http模块的create_loc_conf过程

1、ngx_conf_parse嵌套解析https{}中的配置信息

1、各类merge过程定义配置信息作用范围

1、所有http模块的init_main_conf过程

1、ngx_core_prepare_phasesconn处理流水线过程（可三方模块嵌入）

1、ngx_core_listen_parse将端口信息拷贝listening对象数组，设置处理函数为ngx_http_init_connection（tcp建链完成后的处理函数入口）

3、ngx_server_block

1、新ngx_http_conf_ctx_t对象、新2个成员指向2个指针数组（main_conf共用）

1、所有http模块的create_srv_conf过程

1、所有http模块的create_loc_conf过程

1、ngx_http_core_srv_conf_t对象指针插入根ngx_http_core_main_conf_t对象的servers数组

1、ngx_conf_parse嵌套解析servers{}中的配置信息

1、location排序

4、ngx_location_block

1、新ngx_http_conf_ctx_t对象

1、新loc_conf对象指向1个指针数组（main_conf、srv_conf共用）

1、所有http模块的create_loc_conf过程

1a、ngx_http_core_loc_conf_t指针插入上层ngx_http_core_srv_conf_t对象的location数组

1b、ngx_http_core_loc_conf_t指针插入上层ngx_http_core_loc_conf_t对象的location数组

1、ngx_conf_parse嵌套解析location{}中的配置信息

举例NGX_CORE_MODULE模块NGX_MAIN_CONF配置的解析

1、此时文件未打开，故ngx_open_file打开文件

1、循环用ngx_conf_read_token读取每一行

1、扫描所有模块，对指定模块指定配置进行匹配，并校验配置个数的正确性

1、NGX_DIRECT_CONF配置是直接使用ngx_core_conf_t对象

2、cmd->set是直接使用ngx_core_conf_t对象

3、如ngx_conf_set_flag_slot

1、NGX_MAIN_CONF配置是指针数组，指向特殊对象内存。如event核心模块指向event模块个数组成的指针数组，每个成员指向对应模块的对象（event_core_t模块指向event_conf_t对象，epoll_module模块指向epoll_conf_t对象）

2、cmd->set是指向指针数组（各指针使用各自模块定义的对象）。

3、如ngx_events_block、ngx_http_block

1、其他配置说明该ngx_conf_parse例程处于嵌套中

2、cmd->set是指向指针数组中，当前模块对应的定义对象

3、如ngx_event_connections（event_core根模块中connections配置项）

举例NGX_HTTP_MODULE模块NGX_HTTP_MAIN_CONF配置的解析

1、循环用ngx_conf_read_token读取每一行

1、扫描所有模块，对指定模块指定配置进行匹配，并校验配置个数的正确性

1、其他配置说明该ngx_conf_parse例程处于嵌套中（此时cf->ctx指向起始的ngx_http_conf_ctx_t对象）

2、cmd->set是指向main_conf中，当前模块对应的定义对象

3、如ngx_conf_set_size_slot（http_core根模块中connection_pool_size配置项）

3、如ngx_server_block（http_core根模块中server配置项）

1、ngx_server_block

参数cf指向http_core_main_conf_t对象，cmd指向下面截图内容：

server{}

2、继续创建同样的对象组，调用ngx_conf_parse进行嵌套配置解析NGX_HTTP_SRV_CONF配置（cf->ctx变成新的ngx_http_conf_ctx_t对象）。

举例NGX_HTTP_MODULE模块NGX_HTTP_SRV_CONF配置的解析

1、循环用ngx_conf_read_token读取每一行

1、扫描所有模块，对指定模块指定配置进行匹配，并校验配置个数的正确性

1、其他配置说明该ngx_conf_parse例程处于嵌套中

2、cmd->set是指向srv_conf中，当前模块对应的定义对象

3、如ngx_conf_set_size_slot（http_core根模块中listen配置项）

3、如ngx_location_block（http_core根模块中location配置项）

1、ngx_loc_block

参数cf指向http_core_srv_conf_t对象，cmd指向下面截图内容：

location{}

2、继续创建同样的对象组，调用ngx_conf_parse进行嵌套配置解析NGX_HTTP_LOC_CONF配置（cf->ctx变成新的ngx_http_conf_ctx_t对象）。

举例NGX_HTTP_MODULE模块NGX_HTTP_LOC_CONF配置的解析

1、循环用ngx_conf_read_token读取每一行

1、扫描所有模块，对指定模块指定配置进行匹配，并校验配置个数的正确性

1、其他配置说明该ngx_conf_parse例程处于嵌套中

2、cmd->set是指向srv_conf中，当前模块对应的定义对象

3、如ngx_set_root（http_core根模块中alias配置项）

3、如ngx_location_block（http_core根模块中location配置项）

location是可以无限嵌套的。

总结

文字分析的逻辑往往让人一头雾水，图文并茂才不坑人坑己，配置项影响范围是由各自模块去决定的，本文档讨论的均不涉及merge（各种merge函数起始就是把链表中的数据merge到外圈里的对象而已，很简单）。总结：

配置：

配置信息

对象：

配置信息组织形式

代码：

代码信息

从代码可知，http_test配置项可配置在任意{}中，srv_test配置项只能在server{}或location{}中，listen只能在server{}中，loc_test只能在location{}中，对应的对象组成就是上图所示。

上述总结例子中体现的配置细节不多。其实，http{}中也可以把信息存在loc_conf对象中；http_test存在server{}、location{}中的位置等等。至于作用范围则是根据你的三方模块中如何处理merge钩子了。

配置说明总结

http是最复杂的一个，总结了http模块，其他的就简单了。

1、NGX_HTTP_MAIN_CONF、NGX_HTTP_SRV_CONF、NGX_HTTP_LOC_CONF

NGX_HTTP_MAIN_CONF、NGX_HTTP_SRV_CONF、NGX_HTTP_LOC_CONF分别说明该配置项可以出现再http{}、server{}、location{}中。

2、NGX_CONF_NOARGS、NGX_CONF_TAKE1、NGX_CONF_1MORE

说明参数个数，配置校验使用。

3、NGX_HTTP_MAIN_CONF_OFFSET、NGX_HTTP_SRV_CONF_OFFSET、NGX_HTTP_LOC_CONF_OFFSET

NGX_HTTP_MAIN_CONF_OFFSET、NGX_HTTP_SRV_CONF_OFFSET和NGX_HTTP_LOC_CONF_OFFSET指明该配置信息存储的数组，不同数组的效果如下（假定配置了NGX_HTTP_MAIN_CONF、NGX_HTTP_SRV_CONF、NGX_HTTP_LOC_CONF参数）：

（1）NGX_HTTP_MAIN_CONF_OFFSET

整个http{}中仅能出现一次，否则会冲突，提示“is duplicate”。

（2）NGX_HTTP_SRV_CONF_OFFSET

http{}中仅能直接出现一次，嵌套的每个server{}（整个server{}）也仅能出现一次，否则会冲突，提示“is duplicate”。

（3）NGX_HTTP_LOC_CONF_OFFSET

http{}中仅能直接出现一次，嵌套的每个server{}也仅能直接出现一次，任意server中嵌套的每个location{}也仅能直接出现一次，任意location中嵌套的每个location{}也仅能直接出现一次。

event模块

1、event_core模块

init_module过程: ngx_event_module_init

1、无

init_process过程：ngx_event_process_ini_t

1、获取ngx_event_conf_t对象

1、所有event模块的actions.init过程

1、connections数组、read_events数组、write_events数组

1、端口句柄收信号的处理为ngx_event_accept

1、ngx_add_event添加读事件（端口句柄）

端口读处理函数: ngx_event_accept

1、accept生成业务句柄

1、设置句柄属性

1、ngx_add_conn（如epoll模块的add_conn函数：）

1、执行listening的handle入口（ngx_http_init_connection）

2、epoll模块

init_module过程:

无

init_process过程

无

actions.init过程：ngx_epoll_init

1、epoll_create创建epoll对象

1、epoll_event数组

1、设置ngx_event_actions事件处理接口为epoll模块定义的ngx_epoll_module_ctx对象成员

actions.add_conn过程（ngx_add_conn）：ngx_epoll_add_connection

端口收到信息，ngx_event_accept就会创建业务句柄，执行句柄的add_conn操作。

1、epoll_ctl添加读写事件到epoll对象

actions.add过程（ngx_add_event）：ngx_epoll_add_event

添加事件（读、写等等）

1、epoll_ctl添加/修改读/写事件到epoll对象

http模块

http_core模块

init_module过程:

无

init_process过程

无

ngx_http_init_connection过程

http_core模块针对业务句柄的统一入口，设置事件的处理函数。

1、设置写事件入口为：ngx_http_empty_handler;

1、设置读事件入口为：ngx_http_init_request(rev);并进入

2、创建ngx_http_connection_t对象

2、创建ngx_http_request_t对象

2、创建读缓冲区

2、设置读事件入口为：ngx_http_process_request_line，并进入

3、ngx_http_read_request_header调用connection->recv进行socket读。

3、ngx_http_parse_request_line解析请求行

3、创建headers_in.headers队列、headers_in.cookies数组

3、设置读事件入口为：ngx_http_process_request_headers，并进入

4、ngx_http_read_request_header调用connection->recv进行socket读。

4、读完后调用ngx_http_parse_header_line解析请求头部

4a、头信息正确，记录到headers_in.headers队列

4c、头信息错误，关闭链接

4b、头信息解析完毕，设置读事件入口为：ngx_http_block_read（终止读body，先执行流水线）。

4b、ngx_http_handler进入http流水线处理。

ngx_http_handler过程

1、设置写事件入口为：ngx_http_phase_event_handler

1、执行ngx_http_run_phases

2、（ngx_http_phases定义了阶段。每个阶段有模块入口函数组成的数组。）

2、依次执行每个阶段。调用各个阶段里的函数操作

2、ngx_http_finalize_request请求的收尾工作

---

阶段一：NGX_HTTP_REWRITE_PHASE

ngx_http_rewrite_module模块负责阶段一的工作。

***http_rewrite模块初始化（init_module）：ngx_http_rewrite_init***

设置阶段一NGX_HTTP_REWRITE_PHASE的处理入口为函数ngx_http_rewrite_handler

***阶段一处理：ngx_http_rewrite_handler***

获取所有rewrite配置项信息，依次做正则匹配，替换ngx_http_request_t对象的uri。

一般回复NGX_DECLINED状态进入下一个阶段一处理（没有），最后进入阶段二。

---

阶段二：NGX_HTTP_FIND_CONFIG_PHASE

ngx_http_block中已经设置NGX_HTTP_FIND_CONFIG_PHASE的处理入口函数为ngx_http_find_location_config

***阶段二处理：ngx_http_find_location_config***

使用ngx_http_request_t对象的uri成员去匹配配置文件中的location{}信息，将匹配到的location信息记录到loc_conf成员。（配置代理模式（ngx_http_proxy_module模块的proxy_pass配置项）时，设置content_handler为ngx_http_proxy_handler；配置重定向模式（ngx_http_rewrite_module模块redirect配置项）时，设置content_handler为ngx_http_redirect_handler，要细研究下）

---

阶段三：NGX_HTTP_ACCESS_PHASE

ngx_http_access_module模块负责阶段三的工作。

***ngx_http_access_module模块初始化（init_module）：ngx_http_access_init***

***阶段三处理：ngx_http_access_handler***

匹配ngx_http_access_commands模块的allow配置项，则通过权限验证；

匹配ngx_http_access_commands模块的deny配置项，则不通过权限验证；

---

阶段四：NGX_HTTP_CONTENT_PHASE

ngx_http_index_module模块和ngx_http_static_module模块负责阶段四的工作。

（排在前面的后执行，排在后面的先执行）

***模块初始化（init_module）：ngx_http_index_init、ngx_http_static_init***

***阶段四处理1：ngx_http_index_handler***

1、创建ngx_http_index_ctx_t对象（r->ctx[ngx_http_index_module]）

1、

***阶段四处理2：ngx_http_static_handler***