高级搜索|网站地图|TAG标签RSS订阅[设为首页] [加入收藏]

搜索

热门标签:

当前位置: > Linux服务器 > nginx >

【Nginx】HTTP请求的11个处理阶段

时间:2016-12-17 23:43来源:linux.it.net.cn 作者:IT
Nginx将一个HTTP请求分成多个阶段，以模块为单位进行处理。这样做的好处是使处理过程更加灵活、降低耦合度。HTTP框架将处理分成了11个阶段，各个阶段可以包含任意多个HTTP模块并以流水线的方式处理请求。这11个HTTP阶段如下所示：
[cpp] view plain copy
 
  1. typedef enum {  
  2.     NGX_HTTP_POST_READ_PHASE = 0,   // 接收到完整的HTTP头部后处理的阶段  
  3.    
  4.     NGX_HTTP_SERVER_REWRITE_PHASE,  // URI与location匹配前，修改URI的阶段，用于重定向  
  5.    
  6.     NGX_HTTP_FIND_CONFIG_PHASE,     // 根据URI寻找匹配的location块配置项  
  7.     NGX_HTTP_REWRITE_PHASE,         // 上一阶段找到location块后再修改URI  
  8.     NGX_HTTP_POST_REWRITE_PHASE,    // 防止重写URL后导致的死循环  
  9.    
  10.     NGX_HTTP_PREACCESS_PHASE,       // 下一阶段之前的准备  
  11.    
  12.     NGX_HTTP_ACCESS_PHASE,          // 让HTTP模块判断是否允许这个请求进入Nginx服务器  
  13.     NGX_HTTP_POST_ACCESS_PHASE,     // 向用户发送拒绝服务的错误码，用来响应上一阶段的拒绝  
  14.    
  15.     NGX_HTTP_TRY_FILES_PHASE,       // 为访问静态文件资源而设置  
  16.     NGX_HTTP_CONTENT_PHASE,         // 处理HTTP请求内容的阶段，大部分HTTP模块介入这个阶段  
  17.    
  18.     NGX_HTTP_LOG_PHASE              // 处理完请求后的日志记录阶段  
  19. } ngx_http_phases;  

 
以上11个阶段中，HTTP无法介入的阶段有4个：
  • NGX_HTTP_FIND_CONFIG_PHASE
  • NGX_HTTP_POST_REWRITE_PHASE
  • NGX_HTTP_POST_ACCESS_PHASE
  • NGX_HTTP_TRY_FILES_PHASE
剩余的7个阶段，HTTP模块均能介入，每个阶段可介入模块的个数也是没有限制的，多个HTTP模块可同时介入同一阶段并作用于同一请求。
 
下面是关于阶段的一些定义：
[cpp] view plain copy
 
  1. typedef struct ngx_http_phase_handler_s  ngx_http_phase_handler_t;  
  2.    
  3. typedef ngx_int_t (*ngx_http_phase_handler_pt)(ngx_http_request_t *r,  
  4.     ngx_http_phase_handler_t *ph);  
  5.    
  6. typedef ngx_int_t (*ngx_http_handler_pt)(ngx_http_request_t *r);  
  7.    
  8. struct ngx_http_phase_handler_s {  
  9.     ngx_http_phase_handler_pt  checker; // 由HTTP框架定义和调用，此函数又调用下方的handler方法  
  10.     ngx_http_handler_pt        handler; // HTTP模块通过实现这个方法介入某个阶段  
  11.     ngx_uint_t                 next;    // 下一个阶段的序号  
  12. };  

 
ngx_http_phase_handler_t结构体表示处理阶段中的一个处理方法。当解析完http{}块配置项后，会产生一个由ngx_http_phase_handler_t组成的数组handlers，被放在了ngx_http_phase_engine_t结构体中：
[cpp] view plain copy
 
  1. typedef struct {  
  2.     ngx_http_phase_handler_t  *handlers;    // 一个请求可能经历的所有ngx_http_handler_pt处理方法  
  3.     ngx_uint_t                 server_rewrite_index;  
  4.     ngx_uint_t                 location_rewrite_index;  
  5. } ngx_http_phase_engine_t;  

 
handlers指向了这个数组的起始地址。这个数组是所有HTTP模块都能合作处理用户请求的关键，一个用户请求就是被这个数组中的ngx_http_handler_pt方法依次处理。
 
ngx_http_phase_engine_t结构体又被保存在ngx_http_core_main_conf_t全局结构体（由ngx_http_core_module模块的ngx_http_core_create_main_conf方法创建）中：
[cpp] view plain copy
 
  1. typedef struct {  
  2.     ....  
  3.    
  4.     ngx_http_phase_engine_t    phase_engine;    /* 保存处理HTTP请求的各个阶段 */  
  5.    
  6.     ....  
  7. } ngx_http_core_main_conf_t;  

 
在HTTP框架初始化过程中，任何HTTP模块定义了处理请求的方法ngx_http_handler_pt后，都可以调用自己的接口ngx_http_module_t中的postconfiguration函数将该方法添加到phase_engine中，也就是添加到ngx_http_core_main_conf_t.phase_engine.handlers数组中。当一个HTTP请求到达时，Nginx会调用某阶段的某个ngx_http_handler_pt指向的方法处理请求。介入所有11个阶段均可以使用上述方法。除此之外，介入NGX_HTTP_CONTENT_PHASE阶段还可以使用另外一种方法：把希望处理请求的ngx_http_handler_pt方法设置到location配置块相关的ngx_http_loc_conf_t结构体的handler指针中，如下所示：
[cpp] view plain copy
 
  1. static char* ngx_http_mytest(ngx_conf_t *cf, ngx_command_t *cmd, void *conf)  
  2. {  
  3.     ngx_http_core_loc_conf_t *clcf;  
  4.     
  5.     // 找到mytest配置项所属的配置块  
  6.     clcf = ngx_http_conf_get_module_loc_conf(cf, ngx_http_core_module);  
  7.     
  8.     // 设置处理请求的方法，HTTP框架在处理用户请求进行到NGX_HTTP_CONTENT_PHASE阶段时  
  9.     // 如果主机域名、URI和mytest模块所在配置块名称相同，就会调用函数ngx_http_mytest_handler  
  10.     clcf->handler = ngx_http_mytest_handler;  
  11.     
  12.     return NGX_CONF_OK;  
  13. }  

 
如上例所示，它的好处在于：ngx_http_mytest_handler方法只会处理和该location的URI相匹配的请求，不会处理其它请求。所以，应该根据ngx_http_handler_pt处理方法是处理所有HTTP请求还是处理特定的某个请求，使用不同的方法将ngx_http_handler_pt介入到NGX_HTTP_CONTENT_PHASE阶段。
 
参考：
《深入理解Nginx》 P372-P382.

(责任编辑：IT)
------分隔线----------------------------
栏目列表
推荐内容
热点内容
免责申明 - 版权申明

Copyright © 2014 - 2022 IT网 版权所有 www.it.net.cn IT网.com IT网.cn Linux学习