nginx1.17.9源码分析之管理配置的结构体（1）

我们知道nginx中有一个超级复杂的配置管理数据结构conf_ctx，他是一个多级指针。今天就是分析这个数据结构的形成过程。
首先nginx在启动时对模块的数据结构进行了预初始化。

ngx_int_t ngx_preinit_modules(void)
{
    ngx_uint_t  i;

    for (i = 0; ngx_modules[i]; i++) {
        ngx_modules[i]->index = i;
        ngx_modules[i]->name = ngx_module_names[i];
    }

    ngx_modules_n = i;
    ngx_max_module = ngx_modules_n + NGX_MAX_DYNAMIC_MODULES;

    return NGX_OK;
}

从上面的代码我们可以知道，主要是给nginx中每个模块定义索引。和名字。ngx_modules和ngx_module_names两个变量是在nginx编译的时候，在objs目录下ngx_modules.c中定义的。接着nginx把ngx_modules和ngx_modules_n这两个变量赋值到cycle上。

ngx_int_t
ngx_cycle_modules(ngx_cycle_t *cycle)
{
    cycle->modules = ngx_pcalloc(cycle->pool, (ngx_max_module + 1)
                                              * sizeof(ngx_module_t *));
    
    ngx_memcpy(cycle->modules, ngx_modules,
               ngx_modules_n * sizeof(ngx_module_t *));

    cycle->modules_n = ngx_modules_n;

    return NGX_OK;
}

完成上面这些初始化工作后，nginx开始遍历模块进程处理。

for (i = 0; cycle->modules[i]; i++) {
        if (cycle->modules[i]->type != NGX_CORE_MODULE) {
            continue;
        }

        module = cycle->modules[i]->ctx;

        if (module->create_conf) {
            rv = module->create_conf(cycle);
            cycle->conf_ctx[cycle->modules[i]->index] = rv;
        }
    }

每个NGX_CORE_MODULE模块都会定义一个create_conf的钩子，然后返回一个数据结构，保存到cycle中。下面我们看一下每个NGX_CORE_MODULE模块的定义。

1 ngx_core_module

我们看一下create_conf的实现。

ngx_core_module_create_conf(ngx_cycle_t *cycle)
{
    ngx_core_conf_t  *ccf;

    ccf = ngx_pcalloc(cycle->pool, sizeof(ngx_core_conf_t));

    ccf->daemon = NGX_CONF_UNSET;
    ccf->master = NGX_CONF_UNSET;
    ccf->timer_resolution = NGX_CONF_UNSET_MSEC;
    ccf->shutdown_timeout = NGX_CONF_UNSET_MSEC;

    ccf->worker_processes = NGX_CONF_UNSET;
    ccf->debug_points = NGX_CONF_UNSET;

    ccf->rlimit_nofile = NGX_CONF_UNSET;
    ccf->rlimit_core = NGX_CONF_UNSET;

    ccf->user = (ngx_uid_t) NGX_CONF_UNSET_UINT;
    ccf->group = (ngx_gid_t) NGX_CONF_UNSET_UINT;

    if (ngx_array_init(&ccf->env, cycle->pool, 1, sizeof(ngx_str_t))
        != NGX_OK)
    {
        return NULL;
    }

    return ccf;
}

主要是分配一个结构体，然后初始化字段。在解析配置文件的过程中，根据配置，再次处理结构体里的值。最后在init_conf的时候，如果结构体的字段还没有有效值，则init钩子会给他一个默认值。

2 ngx_errlog_module

log模块没有定义create_conf和init_conf钩子。

3 ngx_events_module

event模块没有定义create_conf钩子。

4 ngx_http_module

http模块没有定义这两个钩子。

5 ngx_regex_module

static void *
ngx_regex_create_conf(ngx_cycle_t *cycle)
{
    ngx_regex_conf_t  *rcf;

    rcf = ngx_pcalloc(cycle->pool, sizeof(ngx_regex_conf_t));
    
    rcf->pcre_jit = NGX_CONF_UNSET;

    ngx_pcre_studies = ngx_list_create(cycle->pool, 8, sizeof(ngx_regex_elt_t));
    return rcf;
}

6 ngx_thread_pool_module

static void *
ngx_thread_pool_create_conf(ngx_cycle_t *cycle)
{
    ngx_thread_pool_conf_t  *tcf;

    tcf = ngx_pcalloc(cycle->pool, sizeof(ngx_thread_pool_conf_t));
    
    if (ngx_array_init(&tcf->pools, cycle->pool, 4,
                       sizeof(ngx_thread_pool_t *))
        != NGX_OK)
    {
        return NULL;
    }

    return tcf;
}

7 ngx_openssl_module

static void *
ngx_openssl_create_conf(ngx_cycle_t *cycle)
{
    ngx_openssl_conf_t  *oscf;

    oscf = ngx_pcalloc(cycle->pool, sizeof(ngx_openssl_conf_t));
    if (oscf == NULL) {
        return NULL;
    }
    return oscf;
}

8 ngx_mail_module

没有实现这个钩子。

9 ngx_google_perftools_module

static void *
ngx_google_perftools_create_conf(ngx_cycle_t *cycle)
{
    ngx_google_perftools_conf_t  *gptcf;

    gptcf = ngx_pcalloc(cycle->pool, sizeof(ngx_google_perftools_conf_t));
    
    return gptcf;
}

10 ngx_stream_module
没有实现钩子。

总结，在对core模块进行初始化后，nginx的配置管理的结构体就如上图所示。在解析配置时和解析配置后，每个模块会对自己的结构体进行相关。这是conf_ctx第一层的示意图，下次我们继续分析。