nginx源码学习（三）配置解析

最新推荐文章于 2024-05-16 17:24:29 发布

原创最新推荐文章于 2024-05-16 17:24:29 发布 · 576 阅读

0 ·

CC 4.0 BY-SA版权

nginx学习专栏收录该内容

8 篇文章

订阅专栏

本文探讨了Nginx配置文件解析的过程，包括ngx_conf_parse()函数如何递归解析配置文件，以及词法分析和指令解析的具体步骤。此外还提到了自定义指令解析机制。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1、以下是我阅读nginx(1.13.2版本)源码的一些心得，个人觉得学一个东西最好学它的思想，学会举一反三。因为互联网的东西实在太多了。

上一章我对nginx ngx_init_cycle做了一个大概的描述，

这一张我对配置文件解析的函数做一下研究。以下是摘自 http://tengine.taobao.org/book/chapter_11.html的概念

ngx_init_cycle.h中的调用解析：

   if (ngx_conf_param(&conf) != NGX_CONF_OK) {
 
          environ = senv;
 
          ngx_destroy_cycle_pools(&conf);
 
          return NULL;
 
      }
 
      if (ngx_conf_parse(&conf, &cycle->conf_file) != NGX_CONF_OK) {
 
          environ = senv;
 
          ngx_destroy_cycle_pools(&conf);
 
          return NULL;
 
      }

配置解析模块在ngx_conf_file.c中实现。模块提供的接口函数主要是ngx_conf_parse，另外，模块提供一个单独的接口ngx_conf_param，用来解析命令行传递的配置，当然，这个接口也是对ngx_conf_parse的包装。

鸟瞰nginx解析配置的流程，整个过程可参见下面示意图：

这是一个递归的过程。nginx首先解析core模块的配置。core模块提供一些块指令，这些指令引入其他类型的模块，nginx遇到这些指令，就重新迭代解析过程，解析其他模块的配置。这些模块配置中又有一些块指令引入新的模块类型或者指令类型，nginx就会再次迭代，解析这些新的配置类型。比如上图，nginx遇到“events”指令，就重新调用ngx_conf_parse()解析event模块配置，解析完以后ngx_conf_parse()返回，nginx继续解析core模块指令，直到遇到“http”指令。nginx再次调用ngx_conf_parse()解析http模块配置的http级指令，当遇到“server”指令时，nginx又一次调用ngx_conf_parse()解析http模块配置的server级指令。

了解了nginx解析配置的流程，我们来看其中的关键函数ngx_conf_parse()。

ngx_conf_parse()解析配置分成两个主要阶段，一个是词法分析，一个是指令解析。

词法分析通过ngx_conf_read_token()函数完成。指令解析有两种方式，其一是使用nginx内建的指令解析机制，其二是使用第三方自定义指令解析机制。自定义指令解析可以参见下面的代码：

if (cf->handler) {
    rv = (*cf->handler)(cf, NULL, cf->handler_conf);
    if (rv == NGX_CONF_OK) {
        continue;
    }

    if (rv == NGX_CONF_ERROR) {
        goto failed;
    }

    ngx_conf_log_error(NGX_LOG_EMERG, cf, 0, rv);

    goto failed;
}

这里注意cf->handler和cf->handler_conf两个属性，其中handler是自定义解析函数指针，handler_conf是conf指针。

因为我们不对具体实现细节进行探究，解析配置文件具体可以参考文章头部的链接，我个人不做扩展开发，所以也没去看具体细节。最后解析的结果就是配置文件中的各个变量都进入了各模块的属性中，供各个模块使用。