Nginx 多阶段 Http 请求处理流程

Mon, 11 Apr 2022 09:42:32 +0000

Nginx 通过将各个阶段的所有模块按序的组织成一条执行链，以流水线的形式依次进行处理。

执行链及流程

nginx执行链的定义如下：

typedef struct {
 ngx_http_phase_handler_t *handlers; /*执行链*/
 ngx_uint_t server_rewrite_index;
 ngx_uint_t location_rewrite_index;
} ngx_http_phase_engine_t;

执行链节点的数据结构定义如下：

struct ngx_http_phase_handler_s {
 ngx_http_phase_handler_pt checker;
 ngx_http_handler_pt handler;
 ngx_uint_t next;
};

对于执行链节点，相同阶段具有相同的checker函数，handler中则保存的是挂载至该阶段的模块处理函数，一般在checker函数中会执行当前节点的handler函数

执行链的执行流程是按照执行链顺序向前执行，但某个阶段需要回跳或跳过之后的某些执行阶段，next字段保存的就是跳跃的目的索引。

各个阶段如下：

NGX_HTTP_POST_READ_PHASE

接受完请求头之后的第一个阶段，位于uri重写之前，默认情况下该阶段被跳过;

nginx源码中仅有realip模块在POST_READ阶段对客户端ip进行了替换，且该模块并未被默认编译进nginx

POST_HEAD阶段的checker函数仅调用对应的handler函数，随后对返回值进行处理，当handler返回NGX_OK时进入下一阶段

NGX_HTTP_SERVER_REWRITE_PHASE

server级别的uri重写阶段，执行于server块内，location块外的重写指令。

nginx的rewrite模块在此阶段提供url重写指令rewrite和变量指令set，以及逻辑控制指令if、break和return以供用户完成一些简单的需求而不必注册handler

该阶段的请求未被匹配至具体的location中

SERVER_REWRITE阶段的checker函数同样调用handler函数，但处理方式稍有不同，当handler返回NGX_DECLINED时进入下一阶段

NGX_HTTP_FIND_CONFIG_PHASE

这一阶段根据重写过的uri查找对应的location，可能被执行多次

通过ngx_http_core_find_location函数完成对r->loc_conf的设置，然后调用ngx_http_update_location_config更新请求相关配置

NGX_HTTP_REWRITE_PHASE

location级别的重写阶段，该阶段执行location基本的重写指令，可能被执行多次。

与SERVER_REWRITE的逻辑基本相同，使用相同的handler函数，只是执行的时机不同。

NGX_HTTP_POST_REWRITE_PHASE

该阶段不能挂载handler，仅用于检查REWRITE阶段是否进行uri重写，若发生重写则返回再次执行REWRITE阶段，默认限制的重写次数为10次

Nginx on Mer's Blog

Nginx 多阶段 Http 请求处理流程

执行链及流程