nginx-filter

filter

对应HTTP请求的响应头和响应体，Nginx分别设置了header filter和body filter。两种机制都是采用链表的方式，不同过滤模块对应链表的一个节点，一般而言一个模块会同时注册header filter和body filter。一个典型的filter模块，比如gzip模块使用类似如下的代码来注册：

    static ngx_http_output_header_filter_pt  ngx_http_next_header_filter;  
    static ngx_http_output_body_filter_pt    ngx_http_next_body_filter;  
      
    ...  
         
    static ngx_int_t  
    ngx_http_gzip_filter_init(ngx_conf_t *cf)  
    {  
        ngx_http_next_header_filter = ngx_http_top_header_filter;  
        ngx_http_top_header_filter = ngx_http_gzip_header_filter;  
      
        ngx_http_next_body_filter = ngx_http_top_body_filter;  
        ngx_http_top_body_filter = ngx_http_gzip_body_filter;  
      
        return NGX_OK;  
    } 

上面的代码中，gzip模块首先在模块的开头声明了两个static类型的全局变量ngx_http_next_header_filter和ngx_http_next_body_filter，在ngx_http_gzip_filter_init函数中，这二个变量分别被赋值为ngx_http_top_header_filter及ngx_http_top_body_filter。而后二者定义在ngx_http.c，并在ngx_http.h头文件中被导出。ngx_http_top_header_filter和ngx_http_top_body_filter实际上是filter链表的头结点，每次注册一个新的filter模块时，它们的值先被保存在新模块的内部全局变量ngx_http_next_header_filter及ngx_http_next_body_filter，然后被赋值为新模块注册的filter函数，而且Nginx filter是先从头节点开始执行，所以越晚注册的模块越早执行。