全面了解Nginx中的HTTP协议相关模块配置

要理解 HTTP 模块配置解析的过程，首先需要对 nginx 的配置文件结构做一个了解

nginx 的配置文件是用树状结构组织的，每个 NGX_CORE_MODULE 作为根统领着其下的所有配置项

而如下图所示，HTTP 模块的配置被分成了 main、server、location 三层

整个 nginx 配置解析的过程其实就是这棵树的深度遍历过程

而遍历 HTTP 子树的函数就是下面要介绍的 ngx_http_block

配置文件解析 -- http 配置块
当我们需要使用 http 模块的时候，我们需要在配置文件中加入 http 配置块：

http { // http 配置块 {{{
  include    mime.types;
  default_type application/octet-stream;
  #log_format main '$remote_addr - $remote_user [$time_local] "$request" 
'
  #         '$status $body_bytes_sent "$http_referer" '
  #         '"$http_user_agent" "$http_x_forwarded_for"';
  #access_log logs/access.log main;
  sendfile    on;
  #tcp_nopush   on;
  #keepalive_timeout 0;
  keepalive_timeout 65;
  #gzip on;
  server {
    listen    8001;
    server_name localhost;
    #autoindex  on;
    #charset koi8-r;
    #access_log logs/host.access.log main;
    location / {
      root  /var/www/;
      index index.html index.htm index.php;

在 http 配置块中，我们配置了 http 连接相关的信息，HTTP 框架也正是从这里启动的.

在 nginx 初始化的过程中，执行了 ngx_init_cycle 函数，其中进行了配置文件解析，调用了 ngx_conf_parse 函数

配置文件解析

函数 ngx_conf_handler 根据配置项的 command 调用了对应的 set 回调函数

// static ngx_int_t ngx_conf_handler(ngx_conf_t *cf, ngx_int_t last)
// 配置项解析 {{{
static ngx_int_t
ngx_conf_handler(ngx_conf_t *cf, ngx_int_t last)
{
  char      *rv;
  void      *conf, **confp;
  ngx_uint_t   i, found;
  ngx_str_t   *name;
  ngx_command_t *cmd;
  name = cf->args->elts;
  found = 0;
  for (i = 0; ngx_modules[i]; i++) {
    cmd = ngx_modules[i]->commands;
    if (cmd == NULL) {
      continue;
    }
    for ( /* void */ ; cmd->name.len; cmd++) {
      if (name->len != cmd->name.len) {
        continue;
      }
      if (ngx_strcmp(name->data, cmd->name.data) != 0) {
        continue;
      }

阅读各模块的 ngx_command_t 命令配置结构，可以找到：

// static ngx_command_t ngx_http_commands
// http 模块命令结构 {{{
static ngx_command_t ngx_http_commands[] = {
  { ngx_string("http"),
   NGX_MAIN_CONF|NGX_CONF_BLOCK|NGX_CONF_NOARGS,
   ngx_http_block,
   0,
   0,
   NULL },
   ngx_null_command
}; // }}}

http 配置块解析 -- ngx_http_block

在解析到 http 配置块时，执行了对应的 set 回调函数 ngx_http_block