Nginx http_core模块 配置文件解析

        Nginx 的配置文件解析很麻烦，数据结构交织在一起，特别恶心，经过几天的分析，得到了一幅大概的关系图，自以为是正确的。

cycle = ngx_init_cycle(&init_cycle)：

       1、在内存池中分配一个ngx_cycle_t变量，并初始化它的各个成员。

       2、调用core类型的create_conf，实际只有一个ngx_core_module_create_conf函数----初始化ngx_core_conf_t结构（存放core_module支持的指令），保存在ngx_cycle->conf_ctx数组中。可以说，此时，ngx_cycle->conf_ctx数组中只有一个ngx_core_conf_t结构。

       3、初始化ngx_conf_t结构。

       4、ngx_conf_parse 解析配置文件，把结果保存在模块对应的ngx_conf里面。

       5、调用core类型的init_conf,实际只有一个ngx_core_module_init_conf函数（初始化对应的ngx_core_conf_t函数）。为什么要init，都已经解析配置文件了，应该在这之前初始化呀--如果值为-1，表明没有设置，初始化默认值！

       6、ngx_open_listening_sockets：遍历listening数组并打开所有侦听sockets(socket()->setsockopt()->bind()->listen())。

       7、调用所有模块的init_module(实际上只有ngx_event_core_module模块定义了该callback，即只有ngx_event_module_init()被调用)。

ngx_conf_parse(ngx_conf_t *cf, ngx_str_t *filename)：

       函数的作用就是循环不停的从配置文件中读取指令，然后进行指令处理，直到结束

1、先分析ngx_core_module的指令及其对应的set函数。

{ ngx_string("daemon"),
      NGX_MAIN_CONF|NGX_DIRECT_CONF|NGX_CONF_FLAG,
      ngx_conf_set_flag_slot,
      0,
      offsetof(ngx_core_conf_t, daemon),  //计算daemon成员在ngx_core_conf_t结构体里面的偏移
NULL },

ngx_conf_set_flag_slot(ngx_conf_t *cf, ngx_command_t *cmd, void *conf)：里面代码很清楚，根据配置指令，设置模块conf结构的成员变量。

2、分析ngx_events_modules的指令及其对应的set函数。只有一条指令：

{ ngx_string("events"),
      NGX_MAIN_CONF|NGX_CONF_BLOCK|NGX_CONF_NOARGS,
      ngx_events_block,
      0,
      0,
      NULL },

    1、ngx_events_module编号为3，于是ngx_cycle->conf_ctx指向的void*数组第3号槽位指向一个void*指针，这个指针又指向一个void*数组（个数==事件类型模块的个数，Linux平台编译之后，只有两个ngx_epoll_module事件模型ngx_event_core_module和ngx_epoll_module）。

    2、调用event类型模块的上下文ngx_event_module_t 的create_conf钩子，为void*数组指定槽位创建相应的conf结构。

    3、更改当前cf环境（NGX_EVENT_MODULE，NGX_EVENT_CONF）解析events{ 块里面的指令。里面的set函数都是根据配置文件设置ngx_event_conf_t结构体里面的成员变量。

3、分析ngx_http_module的指令及其对应的set函数。只有一条指令，如下：

{ ngx_string("http"),
      NGX_MAIN_CONF|NGX_CONF_BLOCK|NGX_CONF_NOARGS,
      ngx_http_block,
      0,
      0,
      NULL },

     ngx_init_cycle创建了core module的config，那么http module相关的config在那里创建呢？http module相关的config是在ngx_http_block中创建（ngx_http_conf_ctx_t)的，在ngx_http_block中会创建，初始化，合并config（未完全看懂），以及整个http handler phase的初始化（还未看）等等。

    1、为ngx_cycle->conf_ctx指向的void*数组创建ngx_http_conf_ctx_t结构，并为ngx_http_conf_ctx_t 创建main_conf srv_conf loc_conf三个void*数组，数组大小为http类型模块的个数。

    2、遍历所有的http类型的模块的上下文ngx_http_module_t，调用create_main_conf、create_srv_conf、create_loc_conf 分别在ngx_http_conf_ctx_t 的三个数组（main_conf srv_conf loc_conf）的对应槽位创建响应的结构体变量。

    3、遍历所有的http类型的模块的上下文ngx_http_module_t， 调用 preconfiguration 钩子函数。

    4、解析http块里面的指令：ngx_conf_parse 未看，当前环境：ctx指向ngx_http_conf_ctx_t，指令类型为NGX_HTTP_MAIN_CONF，模块类型为：NGX_HTTP_MODULE。

            4.1、 遇到http里面的main指令：

 if (cmd->type & NGX_DIRECT_CONF) {
    conf = ((void **) cf->ctx)[ngx_modules[i]->index];  //ngx_core_conf_t
            } else if (cmd->type & NGX_MAIN_CONF) {
             //hp: 比如，遇到http/events指令，这里，conf指向的是cf->ctx的第idx个槽位
                conf = &(((void **) cf->ctx)[ngx_modules[i]->index]);
            } else if (cf->ctx) {
                 //否则进入二级模块处理，比如events/http {里面的指令，都是在这里
                //http 里面的main指令，ctx指向于ngx_http_conf_ctx_t
                confp = *(void **) ((char *) cf->ctx + cmd->conf);                //这里，cmd->conf的作用体现出来了
                if (confp) {
                    //http里面的main指令: conf指向的是对应的ngx_http_core_main_conf_t
                    conf = confp[ngx_modules[i]->ctx_index];
                }
            }

比如variables_hash_max_size 指令：

  { ngx_string("variables_hash_max_size"),
      NGX_HTTP_MAIN_CONF|NGX_CONF_TAKE1,
      ngx_conf_set_num_slot,                            //这里，刚好设置conf（ngx_http_core_main_conf_t） 的variables_hash_max_size的值。
      NGX_HTTP_MAIN_CONF_OFFSET,        //这里，conf+NGX_HTTP_MAIN_CONF_OFFSET就是需要设置的结构体==ngx_http_core_main_conf_t变量地址
      offsetof(ngx_http_core_main_conf_t, variables_hash_max_size),        //需要设置结构体中的哪个成员，成员在结构体中的偏移。
      NULL },  

总结出struct ngx_command_s {   // 这个域主要是供nginx解析配置文件时使用，设置相关的数据结构
    ngx_str_t             name;         //命令名称
    ngx_uint_t            type;         //命令类型(有几个参数等)
    char               *(*set)(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);      //这个conf指向需要设置的结构体变量地址
    ngx_uint_t            conf;         //配置结构体在内存的位置，相对于conf的偏移量，在ngx_conf_handler中使用
    ngx_uint_t            offset;      //要设置结构体的哪个成员，相对于结构体的偏移量
    void                 *post;         //一些读取配置时候的零碎变量，一般为null
};

            4.2  遇到 server指令时：

                    生成一个新的ngx_http_conf_ctx_t，其中main_conf指向原来的，server_conf和loc_conf创建新的void*数组。把ngx_http_core_module的server块配置信息存入 main_conf 中的server 容器里面。更新当前环境。 开始解析server块里面的指令。

cf->ctx = ctx;        //指向新的ngx_http_conf_ctx_t
cf->cmd_type = NGX_HTTP_SRV_CONF;

            4.3  遇到server里面的指令：遇到listen 指令时，ngx_conf_handler中，confp指向的新的ngx_http_conf_ctx_t.srv_conf所指向的void*数组，于是 conf = confp[ngx_modules[i]->ctx_index]；指向listen指令对应的模块（ngx_htt_core_module)的 ngx_http_core_srv_conf_t数据结构。

            4.4  遇到location指令：生成一个新的ngx_http_conf_ctx_t，其中main_conf指向原来的，srv_conf指向上一层ngx_http_conf_ctx_t的srv_conf数组，loc_conf创建新的void*数组。

ngx_http_core_location 这个函数很麻烦，看起来主要是设置ngx_http_loc_conf_ctx_t里面的name变量。然后递归调用ngx_parse_conf解析location里面的命令。

            4.5:  遇到location里面的命令。比如 root，设置ngx_http_loc_conf_ctx_t里面的root变量。

    5、回到ngx_http_block函数！遍历每个http类型的模块，调用模块上下文ngx_http_module_t中的init_main_conf钩子初始化模块对应的main_conf配置信息，然后调用ngx_http_merge_servers。

    6、得到最终的配置信息结构图！

参考：

http://chinaren.wei.blog.163.com/blog/static/13907612920111125112655/

http://www.pagefault.info/?p=368

http://blog.csdn.net/livelylittlefish/article/details/7247080