我们知道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钩子会给他一个默认值。
![88277dd55a9fcb05e62d6fae5368e7aa.png](https://i-blog.csdnimg.cn/blog_migrate/7148caed96c6532c08f125f88faa53e8.jpeg)
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;
}
![1f9f6e1f5f58bf225e97ebd48e64cc73.png](https://i-blog.csdnimg.cn/blog_migrate/a27da3aac33787e2c29e8efc6db01335.jpeg)
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;
}
![f76eaa3cdc308821a1496a718d90baed.png](https://i-blog.csdnimg.cn/blog_migrate/dbc81504dc6f560349fa9e3d482cf722.jpeg)
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;
}
![344a3a7c2a7b5af52ec253cfda5c8dc7.png](https://i-blog.csdnimg.cn/blog_migrate/2e248b8c5fec03e2412ad186f8f570c5.jpeg)
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;
}
![beebc44ae3533b1ce8ea634e18c72c16.png](https://i-blog.csdnimg.cn/blog_migrate/6a78feb40bce57868a045add5ecbb69c.jpeg)
10 ngx_stream_module
没有实现钩子。
总结,在对core模块进行初始化后,nginx的配置管理的结构体就如上图所示。在解析配置时和解析配置后,每个模块会对自己的结构体进行相关。这是conf_ctx第一层的示意图,下次我们继续分析。