【Nginx】核心模块ngx_events_module

// 定义了如何处理感兴趣的配置项
static ngx_command_t  ngx_events_commands[] = {
    {
        ngx_string("events"), /* 只对events块配置项感兴趣 */
        NGX_MAIN_CONF|NGX_CONF_BLOCK|NGX_CONF_NOARGS,
        ngx_events_block,     /* 解析配置项的函数 */
        0,
        0,
        NULL
    },
    ngx_null_command
}; 

static char *
ngx_events_block(ngx_conf_t *cf, ngx_command_t *cmd, void *conf)
{
    char                 *rv;
    void               ***ctx;
    ngx_uint_t            i;
    ngx_conf_t            pcf;
    ngx_event_module_t   *m;
    ngx_event_max_module = 0;
    for (i = 0; ngx_modules[i]; i++)
    {
        if (ngx_modules[i]->type != NGX_EVENT_MODULE)
            continue;
        /* 1.初始化所有事件模块的ctx_index成员
         * 该成员表明了该模块在相同类型模块中的顺序，这会决定以后加载各事件模块的顺序
         */
        ngx_modules[i]->ctx_index = ngx_event_max_module++;
    }
    /* 分配一个存放指针的空间 */
    ctx = ngx_pcalloc(cf->pool, sizeof(void *));
    /* 2.ngx_event_max_module等于事件模块个数 */
    *ctx = ngx_pcalloc(cf->pool, ngx_event_max_module * sizeof(void *));
    *(void **) conf = ctx;  /* conf指向存储参数的结构体 */
    for (i = 0; ngx_modules[i]; i++)
    {
        if (ngx_modules[i]->type != NGX_EVENT_MODULE)
            continue;
        m = ngx_modules[i]->ctx;    /* 得到事件模块的通用接口 */
        if (m->create_conf)
            /* 3.调用所有事件模块的通用接口ngx_event_module_t中的create_conf方法 */
            (*ctx)[ngx_modules[i]->ctx_index] = m->create_conf(cf->cycle);
    }
    pcf = *cf;
    cf->ctx = ctx;
    cf->module_type = NGX_EVENT_MODULE;
    cf->cmd_type = NGX_EVENT_CONF;
    /* 4.针对所有事件模块调用各自的解析配置文件的方法
     * 当发现相应配置项后，就调用模块中ngx_command_t数组中的方法
     */
    rv = ngx_conf_parse(cf, NULL);  /* cf中保存有读到的配置项参数 */
    *cf = pcf;
    for (i = 0; ngx_modules[i]; i++)
    {
        if (ngx_modules[i]->type != NGX_EVENT_MODULE)
            continue;
        m = ngx_modules[i]->ctx;
        if (m->init_conf)
            /* 5.解析完配置项后，调用每个模块的init_conf方法对配置参数进行整合 */
            rv = m->init_conf(cf->cycle, (*ctx)[ngx_modules[i]->ctx_index]);
    }
    return NGX_CONF_OK;
}