NginxHTTP请求的11个处理阶段

Posted ldxsuanfa

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了NginxHTTP请求的11个处理阶段相关的知识,希望对你有一定的参考价值。

nginx将一个HTTP请求分成多个阶段。以模块为单位进行处理。这样做的优点是使处理过程更加灵活、减少耦合度。HTTP框架将处理分成了11个阶段,各个阶段能够包括随意多个HTTP模块并以流水线的方式处理请求。这11个HTTP阶段例如以下所看到的:
typedef enum {
    NGX_HTTP_POST_READ_PHASE = 0,   // 接收到完整的HTTP头部后处理的阶段
 
    NGX_HTTP_SERVER_REWRITE_PHASE,  // URI与location匹配前,改动URI的阶段,用于重定向
 
    NGX_HTTP_FIND_CONFIG_PHASE,     // 依据URI寻找匹配的location块配置项
    NGX_HTTP_REWRITE_PHASE,         // 上一阶段找到location块后再改动URI
    NGX_HTTP_POST_REWRITE_PHASE,    // 防止重写URL后导致的死循环
 
    NGX_HTTP_PREACCESS_PHASE,       // 下一阶段之前的准备
 
    NGX_HTTP_ACCESS_PHASE,          // 让HTTP模块推断是否同意这个请求进入Nginx服务器
    NGX_HTTP_POST_ACCESS_PHASE,     // 向用户发送拒绝服务的错误码,用来响应上一阶段的拒绝
 
    NGX_HTTP_TRY_FILES_PHASE,       // 为訪问静态文件资源而设置
    NGX_HTTP_CONTENT_PHASE,         // 处理HTTP请求内容的阶段,大部分HTTP模块介入这个阶段
 
    NGX_HTTP_LOG_PHASE              // 处理完请求后的日志记录阶段
} 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模块可同一时候介入同一阶段并作用于同一请求。

以下是关于阶段的一些定义:
typedef struct ngx_http_phase_handler_s  ngx_http_phase_handler_t;
 
typedef ngx_int_t (*ngx_http_phase_handler_pt)(ngx_http_request_t *r,
    ngx_http_phase_handler_t *ph);
 
typedef ngx_int_t (*ngx_http_handler_pt)(ngx_http_request_t *r);
 
struct ngx_http_phase_handler_s {
    ngx_http_phase_handler_pt  checker; // 由HTTP框架定义和调用,此函数又调用下方的handler方法
    ngx_http_handler_pt        handler; // HTTP模块通过实现这种方法介入某个阶段
    ngx_uint_t                 next;    // 下一个阶段的序号
};


ngx_http_phase_handler_t结构体表示处理阶段中的一个处理方法。当解析完http{}块配置项后。会产生一个由ngx_http_phase_handler_t组成的数组handlers,被放在了ngx_http_phase_engine_t结构体中:
typedef struct {
    ngx_http_phase_handler_t  *handlers;    // 一个请求可能经历的全部ngx_http_handler_pt处理方法
    ngx_uint_t                 server_rewrite_index;
    ngx_uint_t                 location_rewrite_index;
} 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方法创建)中:
typedef struct {
    ....
 
    ngx_http_phase_engine_t    phase_engine;    /* 保存处理HTTP请求的各个阶段 */
 
    ....
} 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指针中。例如以下所看到的:
static char* ngx_http_mytest(ngx_conf_t *cf, ngx_command_t *cmd, void *conf)
{
    ngx_http_core_loc_conf_t *clcf;
  
    // 找到mytest配置项所属的配置块
    clcf = ngx_http_conf_get_module_loc_conf(cf, ngx_http_core_module);
  
    // 设置处理请求的方法,HTTP框架在处理用户请求进行到NGX_HTTP_CONTENT_PHASE阶段时
    // 假设主机域名、URI和mytest模块所在配置块名称同样。就会调用函数ngx_http_mytest_handler
    clcf->handler = ngx_http_mytest_handler;
  
    return NGX_CONF_OK;
}


如上例所看到的,它的优点在于:ngx_http_mytest_handler方法仅仅会处理和该location的URI相匹配的请求,不会处理其他请求。所以,应该依据ngx_http_handler_pt处理方法是处理全部HTTP请求还是处理特定的某个请求。使用不同的方法将ngx_http_handler_pt介入到NGX_HTTP_CONTENT_PHASE阶段。


參考:
《深入理解Nginx》 P372-P382.













以上是关于NginxHTTP请求的11个处理阶段的主要内容,如果未能解决你的问题,请参考以下文章

Nginx处理请求的11个阶段

Nginx处理HTTP请求的11个阶段

HTTP请求的11个处理阶段

nginx 11个处理阶段 && nginx lua 8个处理阶段

07《Nginx 入门教程》Nginx 的 Http 模块介绍(上)

nginx http模块开发入门