了解下nginx的http的模块

了解下nginx的http的模块。

在编写nginx的http的模块的时候,需要在各个阶段对http请求做相应的处理,以达到不同的目的,比如请求发起的时候是否有访问权限、内容生成的时候进行过滤或者其它处理等等。如果在编译nginx模块内注册的处理阶段不正确会导致达不到想要的结果，比如你想处理内容的时候内容实际上这个时候是没有的，如此等等。

在nginx内部定义了多个阶段的类型以满足不同的处理要求(ngx_http_core_module.h中,不同版本不一样)：

typedef enum {
    NGX_HTTP_POST_READ_PHASE = 0  //读取请求阶段
    NGX_HTTP_SERVER_REWRITE_PHASE //URI转换阶段
    NGX_HTTP_FIND_CONFIG_PHASE   //查找相应的配置来执行阶段
    NGX_HTTP_REWRITE_PHASE    //URI转换阶段（不太清楚此处）
    NGX_HTTP_POST_REWRITE_PHASE  //对转换后的URL结果进行处理的阶段
    NGX_HTTP_PREACCESS_PHASE   //权限检查准备阶段
    NGX_HTTP_ACCESS_PHASE    //权限检查阶段
    NGX_HTTP_POST_ACCESS_PHASE  //对权限检查结果进行处理阶段
    NGX_HTTP_TRY_FILES_PHASE   //处理配置中的try_files阶段
    NGX_HTTP_CONTENT_PHASE    //处理生成返回数据阶段(此处认为不太细，当然有filter也可以忽略)
    NGX_HTTP_LOG_PHASE     //记录日志处理阶段，具体说明应当是请求完成后，关闭请求时处理
} 
ngx_http_phases;

从这个配置中可以分析出来nginx在处理请求的整个流程,流程是从头执行到尾的，可见LOG是放在最后面执行，对于内容段的处理一般都是在filter模块中去做，在NGX_HTTP_LOG_PHASE阶段注册的处理段也不能获取到返回的数据，返回数据在发送至客户端后就直接给释放了。因此，在各个阶段处理时应当清楚这个阶段的数据准备情况。

正常情况下，我们可以通过如下的方式来注册我们自己的处理模块：

static ngx_int_t
ngx_http_xxx_init(ngx_conf_t *cf)
{
 ngx_http_handler_pt  *h;
 ngx_http_core_main_conf_t *cmcf;
  
 cmcf = ngx_http_conf_get_module_main_conf(cf, ngx_http_core_module);
  
 h = ngx_array_push(&cmcf->phases[NGX_HTTP_CONTENT_PHASE].handlers);
 if (h == NULL) {
 return NGX_ERROR;
 }
  
 *h = ngx_http_xxx_handler;
  
 return NGX_OK;
}

且ngx_http_xxx_up_handler的返回值只能是如下几个:

NGX_OK        //处理成功，进入下一阶段
NGX_DECLINED      //放弃处理
NGX_AGAIN || NGX_DONE  //处理完成，返回该值会触发请求
NGX_ERROR || NGX_HTTP_.. //处理错误或者HTTP的其它状态值

另外对于NGX_HTTP_CONTENT_PHASE阶段，实际上还有另外一种注册方式，Just like this:

static char *
ngx_http_xxx_server(ngx_conf_t *cf, ngx_command_t *cmd, void *conf)
{
 ngx_str_t     *value;
 ngx_url_t     u;
 ngx_http_core_loc_conf_t *clcf;
  
 clcf = ngx_http_conf_get_module_loc_conf(cf, ngx_http_core_module);
  
 clcf->handler = ngx_http_xxx_handler;
  
 if (clcf->name.data[clcf->name.len - 1] == '/') {
 clcf->auto_redirect = 1;
 }
  
 return NGX_CONF_OK;
}

不过这样子，你要做的东西就太多了,更多的情况下考虑下upstream结合或者对请求进行特殊处理，比如对于分布式存储的分发，需要对请求处理和文件系统关联时、比如请求的数据直接交给特殊的SERVER来拿内容时。