09_Nginx_filter模块

刚接触 filter模块的我是懵的，只知道这是个过滤报文和响应头的。不清楚怎么用。
那么今天，就扒一扒 filter

1. 什么是filter

让我真正明白filter的是这句话

HTTP过滤模块仅处理 服务器发往客户端的HTTP响应，而不处理客户端发往服务器的HTTP请求

很清晰，这个明白了filter的定位，
在Nginx中，HTTP响应被分为两个部分，HTTP头部和HTTP包体。所以，过滤模块就会有选择的只处理HTTP头部或者HTTP包体。

2.filter的形式

filter的形式是以列表的形式

链表的每一个元素都是一个独立的C源代码 文件，而这个C源代码文件会通过两个static静态指针（分别用于处理HTTP头部和HTTP包 体）再指向下一个文件中的过滤方法。

这两个指针在HTTP框架中的定义如下，指向链表的第一个元素，这个单链表我有点困惑。

typedef ngx_int_t (*ngx_http_output_header_filter_pt)(ngx_http_request_t *r);
typedef ngx_int_t (*ngx_http_output_body_filter_pt)
    (ngx_http_request_t *r, ngx_chain_t *chain);

3. filter的调用

明白了filter的定位，自然而然可以知道filter的调用位置。
在发送HTTP响应的时候，我们会调用两个函数，分别发送HTTP响应头(ngx_http_send_header)和HTTP响应体(ngx_http_output_filter);那么在这两个函数中，就会调用filter，下面为两个函数源代码。

3.1 ngx_http_send_header

ngx_int_t
ngx_http_send_header(ngx_http_request_t *r)
{
    if (r->post_action) {
        return NGX_OK;
    }

    if (r->header_sent) {
        ngx_log_error(NGX_LOG_ALERT, r->connection->log, 0,
                      "header already sent");
        return NGX_ERROR;
    }

    if (r->err_status) {
        r->headers_out.status = r->err_status;
        r->headers_out.status_line.len = 0;
    }

    // 此处是从ngx_http_top_header_filter过滤模块开始遍历所有的HTTP头部过滤模块
    return ngx_http_top_header_filter(r);
}

3.1 ngx_http_output_filter

ngx_int_t
ngx_http_output_filter(ngx_http_request_t *r, ngx_chain_t *in)
{
    ngx_int_t          rc;
    ngx_connection_t  *c;

    c = r->connection;

    ngx_log_debug2(NGX_LOG_DEBUG_HTTP, c->log, 0,
                   "http output filter \"%V?%V\"", &r->uri, &r->args);

	//此处是从ngx_http_top_body_filter过滤模块开始遍历所有的HTTP包体过滤模块
    rc = ngx_http_top_body_filter(r, in);

    if (rc == NGX_ERROR) {
        /* NGX_ERROR may be returned by any filter */
        c->error = 1;
    }

    return rc;
}