专栏首页原创分享nginx1.17.9源码分析之管理配置的结构体(1)

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

之前对nginx0.1.0版本进行了部分代码的分析,接下来的时间,打算以最新版的源码为基础,重新开始分析nginx的实现。这是第一篇。

我们知道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第一层的示意图,下次我们继续分析。

本文分享自微信公众号 - 编程杂技(theanarkh),作者:theanarkh

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2020-03-15

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • 从nginx1.17.9源码理解nginx -s reload

    使用nginx的时候,我们经常会使用nginx -s reload命令重启。下面我们就分析一下,执行这个命令的时候,nginx里发生了什么?我们从nginx的m...

    theanarkh
  • nginx的timeout(基于nginx1.17.9)

    nginx中使用timeout的地方非常多,本文主要分析客户端和nginx通信时涉及到的几个timeout。

    theanarkh
  • nginx0.1.0之http模块初始化源码分析(2)

    本文讲解http各个模块create_srv_conf和create_loc_conf钩子,还有指令的解析。 各模块的create_srv_conf和creat...

    theanarkh
  • nginx lua api解读

    标识response结束,ngx.eof()只是结束响应流的输出,中断HTTP连接,后面的代码逻辑还会继续在服务端执行

    codecraft
  • 从nginx1.17.9源码理解nginx -s reload

    使用nginx的时候,我们经常会使用nginx -s reload命令重启。下面我们就分析一下,执行这个命令的时候,nginx里发生了什么?我们从nginx的m...

    theanarkh
  • nginx0.1.0之event模块初始化源码分析(3)

    前面已经分析了event初始化的整体流程和第一步create_conf,接下来看一下第二步ngx_conf_parse。这里不分析该函数的代码,该函数主要是遍历...

    theanarkh
  • Nginx vs Envoy vs Mosn 平滑升级原理解析

    本文适合对 Nginx 实现原理比较感兴趣的同学阅读,需要具备一定的网络编程知识。

    poslua
  • AD RMS高可用(一)rms工作原理及实验环境

              Active Directory 权限管理服务 (AD RMS) 是一种信息保护技术,它与支持 AD RMS 的应用程序协同工作,以防止在未...

    月缺
  • nginx lua重置请求参数及常量备忘

    codecraft
  • ActiveMQ详解(3)——JMS消息的高级特性

    张申傲

扫码关注云+社区

领取腾讯云代金券