要理解 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_tngx_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
static char *ngx_http_block(ngx_conf_t *cf, ngx_command_t *cmd, void *conf){ char *rv; ngx_uint_t mi, m, s; ngx_conf_t pcf; ngx_http_module_t *module; ngx_http_conf_ctx_t *ctx; ngx_http_core_loc_conf_t *clcf; ngx_http_core_srv_conf_t **cscfp; ngx_http_core_main_conf_t *cmcf; /* the main http context */ ctx = ngx_pcalloc(cf->pool, sizeof(ngx_http_conf_ctx_t)); if (ctx == NULL) { return NGX_CONF_ERROR; } // 创建 http 配置结构，保存所有 http 模块的配置信息 *(ngx_http_conf_ctx_t **) conf = ctx; /* count the number of the http modules and set up their indices */ ngx_http_max_module = 0; for (m = 0; ngx_modules[m]; m++) { if (ngx_modules[m]->type != NGX_HTTP_MODULE) { continue; } // 重新设定 HTTP 模块序号 ngx_modules[m]->ctx_index = ngx_http_max_module++; } /* the http main_conf context, it is the same in the all http contexts */ ctx->main_conf = ngx_pcalloc(cf->pool, sizeof(void *) * ngx_http_max_module); if (ctx->main_conf == NULL) { return NGX_CONF_ERROR; } /* * the http null srv_conf context, it is used to merge * the server{}s' srv_conf's */ ctx->srv_conf = ngx_pcalloc(cf->pool, sizeof(void *) * ngx_http_max_module); if (ctx->srv_conf == NULL) { return NGX_CONF_ERROR; } /* * the http null loc_conf context, it is used to merge * the server{}s' loc_conf's */ ctx->loc_conf = ngx_pcalloc(cf->pool, sizeof(void *) * ngx_http_max_module); if (ctx->loc_conf == NULL) { return NGX_CONF_ERROR; } /* * create the main_conf's, the null srv_conf's, and the null loc_conf's * of the all http modules */ for (m = 0; ngx_modules[m]; m++) { if (ngx_modules[m]->type != NGX_HTTP_MODULE) { continue; } module = ngx_modules[m]->ctx; mi = ngx_modules[m]->ctx_index; if (module->create_main_conf) { // 调用每个模块的 create_main_conf 回调函数 // 创建自己的 main_conf // // ngx_http_core_module ngx_http_core_create_main_conf // ngx_http_log_module ngx_http_log_create_main_conf // ngx_http_upstream_module ngx_http_upstream_create_main_conf // ngx_http_map_module ngx_http_map_create_conf // ngx_http_ssi_filter_module ngx_http_ssi_create_main_conf // ngx_http_charset_filter_module ngx_http_charset_create_main_conf ctx->main_conf[mi] = module->create_main_conf(cf); if (ctx->main_conf[mi] == NULL) { return NGX_CONF_ERROR; } } if (module->create_srv_conf) { // 调用每个模块的 create_srv_conf 回调函数 // 创建自己的 srv_conf // // ngx_http_core_module ngx_http_core_create_srv_conf // ngx_http_ssl_module ngx_http_ssl_create_srv_conf // ngx_http_upstream_hash_module ngx_http_upstream_hash_create_conf // ngx_http_upstream_least_conn_module ngx_http_upstream_least_conn_create_conf // ngx_http_upstream_keepalive_module ngx_http_upstream_keepalive_create_conf ctx->srv_conf[mi] = module->create_srv_conf(cf); if (ctx->srv_conf[mi] == NULL) { return NGX_CONF_ERROR; } } if (module->create_loc_conf) { // 调用每个模块的 create_loc_conf 回调函数 // 创建自己的 loc_conf // // ngx_http_core_module ngx_http_core_create_loc_conf // ngx_http_log_module ngx_http_log_create_loc_conf // ngx_http_gzip_static_module ngx_http_gzip_static_create_conf // ngx_http_autoindex_module ngx_http_autoindex_create_loc_conf // ngx_http_index_module ngx_http_index_create_loc_conf // ngx_http_auth_basic_module ngx_http_auth_basic_create_loc_conf // ngx_http_access_module ngx_http_access_create_loc_conf // ngx_http_limit_conn_module ngx_http_limit_conn_create_conf // ngx_http_limit_req_module ngx_http_limit_req_create_conf // ngx_http_referer_module ngx_http_referer_create_conf // ngx_http_rewrite_module ngx_http_rewrite_create_loc_conf // ngx_http_proxy_module ngx_http_proxy_create_loc_conf // ngx_http_fastcgi_module ngx_http_fastcgi_create_loc_conf // ngx_http_uwsgi_module ngx_http_uwsgi_create_loc_conf // ngx_http_scgi_module ngx_http_scgi_create_loc_conf // ngx_http_memcached_module ngx_http_memcached_create_loc_conf // ngx_http_browser_module ngx_http_browser_create_conf // ngx_http_gzip_filter_module ngx_http_gzip_create_conf // ngx_http_ssi_filter_module ngx_http_ssi_create_loc_conf // ngx_http_charset_filter_module ngx_http_charset_create_loc_conf // ngx_http_userid_filter_module ngx_http_userid_create_conf // ngx_http_headers_filter_module ngx_http_headers_create_conf // ngx_http_copy_filter_module ngx_http_copy_filter_create_conf ctx->loc_conf[mi] = module->create_loc_conf(cf); if (ctx->loc_conf[mi] == NULL) { return NGX_CONF_ERROR; } } } pcf = *cf; cf->ctx = ctx; for (m = 0; ngx_modules[m]; m++) { if (ngx_modules[m]->type != NGX_HTTP_MODULE) { continue; } module = ngx_modules[m]->ctx; if (module->preconfiguration) { // 调用每个模块的 preconfiguration 回调函数 // // ngx_http_core_module ngx_http_core_preconfiguration // ngx_http_upstream_module ngx_http_upstream_add_variables // ngx_http_ssl_module ngx_http_ssl_add_variables // ngx_http_proxy_module ngx_http_proxy_add_variables // ngx_http_fastcgi_module ngx_http_fastcgi_add_variables // ngx_http_browser_module ngx_http_browser_add_variable // ngx_http_stub_status_module ngx_http_stub_status_add_variables // ngx_http_gzip_filter_module ngx_http_gzip_add_variables // ngx_http_ssi_filter_module ngx_http_ssi_preconfiguration // ngx_http_userid_filter_module ngx_http_userid_add_variables if (module->preconfiguration(cf) != NGX_OK) { return NGX_CONF_ERROR; } } } /* parse inside the http{} block */ cf->module_type = NGX_HTTP_MODULE; cf->cmd_type = NGX_HTTP_MAIN_CONF; rv = ngx_conf_parse(cf, NULL); if (rv != NGX_CONF_OK) { goto failed; } /* * init http{} main_conf's, merge the server{}s' srv_conf's * and its location{}s' loc_conf's */ cmcf = ctx->main_conf[ngx_http_core_module.ctx_index]; cscfp = cmcf->servers.elts; for (m = 0; ngx_modules[m]; m++) { if (ngx_modules[m]->type != NGX_HTTP_MODULE) { continue; } module = ngx_modules[m]->ctx; mi = ngx_modules[m]->ctx_index; /* init http{} main_conf's */ if (module->init_main_conf) { // 调用每个模块的 init_main_conf 回调函数 // 初始化自己的 main_conf // // ngx_http_core_module ngx_http_core_init_main_conf // ngx_http_upstream_module ngx_http_upstream_init_main_conf // ngx_http_ssi_filter_module ngx_http_ssi_init_main_conf rv = module->init_main_conf(cf, ctx->main_conf[mi]); if (rv != NGX_CONF_OK) { goto failed; } } // 合并同名配置项 rv = ngx_http_merge_servers(cf, cmcf, module, mi); if (rv != NGX_CONF_OK) { goto failed; } } /* create location trees */ for (s = 0; s < cmcf->servers.nelts; s++) { clcf = cscfp[s]->ctx->loc_conf[ngx_http_core_module.ctx_index]; if (ngx_http_init_locations(cf, cscfp[s], clcf) != NGX_OK) { return NGX_CONF_ERROR; } if (ngx_http_init_static_location_trees(cf, clcf) != NGX_OK) { return NGX_CONF_ERROR; } } if (ngx_http_init_phases(cf, cmcf) != NGX_OK) { return NGX_CONF_ERROR; } if (ngx_http_init_headers_in_hash(cf, cmcf) != NGX_OK) { return NGX_CONF_ERROR; } for (m = 0; ngx_modules[m]; m++) { if (ngx_modules[m]->type != NGX_HTTP_MODULE) { continue; } module = ngx_modules[m]->ctx; if (module->postconfiguration) { // 调用每个 HTTP 模块的 postconfiguration 回调函数 // // ngx_http_log_module ngx_http_log_init // ngx_http_static_module ngx_http_static_init // ngx_http_gzip_static_module ngx_http_gzip_static_init // ngx_http_autoindex_module ngx_http_autoindex_init // ngx_http_index_module ngx_http_index_init // ngx_http_auth_basic_module ngx_http_auth_basic_init // ngx_http_access_module ngx_http_access_init // ngx_http_limit_conn_module ngx_http_limit_conn_init // ngx_http_limit_req_module ngx_http_limit_req_init // ngx_http_rewrite_module ngx_http_rewrite_init // ngx_http_ssl_module ngx_http_ssl_init // ngx_http_write_filter_module ngx_http_write_filter_init // ngx_http_header_filter_module ngx_http_header_filter_init // ngx_http_chunked_filter_module ngx_http_chunked_filter_init // ngx_http_range_body_filter_module ngx_http_range_body_filter_init // ngx_http_gzip_filter_module ngx_http_gzip_filter_init // ngx_http_postpone_filter_module ngx_http_postpone_filter_init // ngx_http_ssi_filter_module ngx_http_ssi_filter_init // ngx_http_charset_filter_module ngx_http_charset_postconfiguration // ngx_http_userid_filter_module ngx_http_userid_init // ngx_http_headers_filter_module ngx_http_headers_filter_init // ngx_http_copy_filter_module ngx_http_copy_filter_init // ngx_http_range_body_filter_module ngx_http_range_body_filter_init // ngx_http_not_modified_filter_module ngx_http_not_modified_filter_init if (module->postconfiguration(cf) != NGX_OK) { return NGX_CONF_ERROR; } } } // 初始化所有的变量 // 不仅包括HTTP core模块的变量 // 也包括其他的HTTP模块导出的变量，以及配置文件中使用 set 命令设置的变量 // 这里的初始化包括初始化hash表，以及初始化数组索引 if (ngx_http_variables_init_vars(cf) != NGX_OK) { return NGX_CONF_ERROR; } /* * http{}'s cf->ctx was needed while the configuration merging * and in postconfiguration process */ *cf = pcf; // 初始化 phase_engine 结构 if (ngx_http_init_phase_handlers(cf, cmcf) != NGX_OK) { return NGX_CONF_ERROR; } /* optimize the lists of ports, addresses and server names */ // 创建 http 连接，并设置为监听状态 if (ngx_http_optimize_servers(cf, cmcf, cmcf->ports) != NGX_OK) { return NGX_CONF_ERROR; } return NGX_CONF_OK;failed: *cf = pcf; return rv;} // }}}
