10.7　HTTP框架的初始化流程

本节将综合10.1节～10.6节的内容，完整地介绍HTTP框架的初始化过程。实际上，这个初始化过程就在ngx_http_module模块中，当配置文件中出现了http{}配置块时就回调ngx_http_block方法，而这个方法就包括了HTTP框架的完整初始化流程，如图10-10所示。

图　10-10　HTTP框架的初始化流程

下面分别介绍图10-10中的15个步骤。

1）按照在ngx_modules数组中的顺序，由0开始依次递增地设置所有HTTP模块的ctx_index字段。这个字段的值将决定HTTP模块应用于请求时的顺序。

2）第2步～第7步实际上就是10.2.1节中描述的内容。解析到http{}块时产生1个ngx_http_conf_ctx_t结构体，同时初始化它的main_conf、srv_conf、loc_conf 3个指针数组，数组的容量就是第1步中获取到的所有HTTP模块的数量。

3）依次调用所有HTTP模块的create_main_conf方法，产生的配置结构体指针将按照各模块ctx_index字段指定的顺序放入ngx_http_conf_ctx_t结构体的main_conf数组中。

4）依次调用所有HTTP模块的create_srv_conf方法，产生的配置结构体指针将按照各模块ctx_index字段指定的顺序放入ngx_http_conf_ctx_t结构体的srv_conf数组中。

5）依次调用所有HTTP模块的create_loc_conf方法，产生的配置结构体指针将按照各模块ctx_index字段指定的顺序放入ngx_http_conf_ctx_t结构体的loc_conf数组中。

6）依次调用所有HTTP模块的preconfiguration方法。

7）解析http{}块下的main级别配置项。

注意　在解析main级别配置项时，如果遇到server{}配置块，将会触发ngx_http_core_server方法，并开始解析server级别下的配置项，这一过程可参见10.2.2节。在解析srv级别配置项时，如果遇到location{}配置块，将会触发ngx_http_core_location方法，并开始解析location级别下的配置项，这一过程可参见10.2.3节。

8）依次调用所有HTTP模块的init_main_conf方法。

9）调用ngx_http_merge_servers方法合并配置项，这一步骤的内容与10.2.4节介绍的多级别配置项合并是一致的。

10）按照10.5节介绍的方式，创建由location块构造的静态二叉平衡查找树。

11）在10.6节中我们介绍过，有7个HTTP阶段（NGX_HTTP_POST_READ_PHASE、NGX_HTTP_SERVER_REWRITE_PHASE、NGX_HTTP_REWRITE_PHASE、NGX_HTTP_PREACCESS_PHASE、NGX_HTTP_ACCESS_PHASE、NGX_HTTP_CONTENT_PHASE、NGX_HTTP_LOG_PHASE）是允许任何一个HTTP模块实现自己的ngx_http_handler_pt处理方法，并将其加入到这7个阶段中去的。在调用HTTP模块的postconfiguration方法向这7个阶段中添加处理方法前，需要先将phases数组中这7个阶段里的handlers动态数组初始化（ngx_array_t类型需要执行ngx_array_init方法初始化），在这一步骤中，通过调用ngx_http_init_phases方法来初始化这7个动态数组。

12）依次调用所有HTTP模块的postconfiguration方法。HTTP模块可以在这一步骤中将自己的ngx_http_handler_pt处理方法添加到以上7个HTTP阶段中。

13）在上一步中，各HTTP模块会向全局的ngx_http_core_main_conf_t结构体中的phases数组添加处理方法，该数组中存在11个成员，每个成员都是动态数组，可能包含任何数量的处理方法。这一步骤将遍历以上所有处理方法，构造由所有处理方法构成的有序的phase_engine.handlers数组。关于HTTP阶段的用法可参见10.6节。

14）这一步骤构造server虚拟主机构成的支持通配符的散列表，可参见10.4节的内容。

15）这一步骤构造监听端口与server间的关联关系，设置新连接事件的回调方法为ngx_http_init_connection，可参见10.3节。

以上15个步骤就是HTTP框架在Nginx的启动过程中所做的主要工作。