本来想跟着源码深入进去的,搞了几天,细节太多了,怕写的混乱,于是引入一段书中《深入理解nginx模块开发与架构解析》对该函数的流程说明
这个方法就包 括了HTTP框架的完整初始化流程,如图所示。 下面分别介绍图的15个步骤。
- 按照在ngx_modules数组中的顺序,由0开始依次递增地设置所有HTTP模块的ctx_index字段,这个字段的值将决定HTTP模块应用于请 求时的顺序。
- 第2步~第7步实际上会在解析到http{}块 时产生1个ngx_http_conf_ctx_t结构体,同时初始化它的main_conf、 srv_conf、loc_conf 3个指针数组,数组的容量就是第1步中获取到的所 有HTTP模块的数量。
- 依次调用所有HTTP模块的create_main_conf方法,产生的配置结 构体指针将按照各模块ctx_index字段指定的顺序放入 ngx_http_conf_ctx_t结构体的main_conf数组中。
- 依次调用所有HTTP模块的create_srv_conf方法,产生的配置结构体指针将按照各模块ctx_index字段指定的顺序放入 ngx_http_conf_ctx_t结构体的srv_conf数组中。
- 依次调用所有HTTP模块的create_loc_conf方法,产生的配置结 构体指针将按照各模块ctx_index字段指定的顺序放入 ngx_http_conf_ctx_t结构体的loc_conf数组中。
- 依次调用所有HTTP模块的preconfiguration方法。
- 解析http{}块下的main级别配置项。
- 依次调用所有HTTP模块的init_main_conf方法。注意 在解析main级别配置项时,如果遇到server{}配置块,将 会触发ngx_http_core_server方法,并开始解析server级别下的配置项。在解析srv级别配置项时,如果遇到location{}配置块,将会触发ngx_http_core_location方法,并开始解析location级别下 的配置项。
- 调用ngx_http_merge_servers方法合并配置项,这一步骤的内容 与10.2.4节介绍的多级别配置项合并是一致的。
- 创建由location块构造的静态二叉平衡 查找树。
- 有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个动态数组 - 依次调用所有HTTP模块的postconfiguration方法。HTTP模块可 以在这一步骤中将自己的ngx_http_handler_pt处理方法添加到以上7个 HTTP阶段中。
- 在上一步中,各HTTP模块会向全局的 ngx_http_core_main_conf_t结构体中的phases数组添加处理方法,该数组
中存在11个成员,每个成员都是动态数组,可能包含任何数量的处理方 法。这一步骤将遍历以上所有处理方法,构造由所有处理方法构成的有
序的phase_engine.handlers数组。 - 这一步骤构造server虚拟主机构成的支持通配符的散列表,
- 这一步骤构造监听端口与server间的关联关系,设置新连接事 件的回调方法为ngx_http_init_connection。 以上15个步骤就是HTTP框架在Nginx的启动过程中所做的主要工 作。