ngx_http_top_header_filter

原创于 2025-05-30 17:01:21 发布 · 661 阅读

CC 4.0 BY-SA版权

文章标签：

extern ngx_http_output_header_filter_pt  ngx_http_top_header_filter;

这段代码来自于 Nginx 源码（ngx_http.h 或相关头文件），它声明了一个全局函数指针变量，用于实现 Nginx 的 HTTP 响应头过滤链（Header Filter Chain）机制。

extern ngx_http_output_header_filter_pt  ngx_http_top_header_filter;

extern:
声明该变量在其他文件中定义，表示此处仅引用该全局变量。
ngx_http_output_header_filter_pt:
这是一个函数指针类型，定义如下（简化）：
```
typedef ngx_int_t (*ngx_http_output_header_filter_pt)(ngx_http_request_t *r);
```
它指向一个函数，该函数接收 ngx_http_request_t*（HTTP 请求结构体），返回 ngx_int_t（通常表示成功或错误码）。
ngx_http_top_header_filter:
全局变量，保存当前头部过滤链的入口函数指针。

Nginx 的 HTTP 响应处理分为头部过滤链和主体过滤链，通过模块化的方式允许各模块按顺序处理响应。

头部过滤链：
负责处理 HTTP 响应头（如修改 Content-Type、添加/删除头部字段等）。
链式调用：
每个模块可以注册自己的过滤函数，Nginx 通过 ngx_http_top_header_filter 指向链表的头部，依次调用各模块的过滤函数。

初始化阶段：
Nginx 在启动时，各模块通过 ngx_http_next_header_filter 将自身的过滤函数插入链中。
例如，ngx_http_not_modified_filter_module 会检查 If-Modified-Since 头。
运行时调用：
当 Nginx 准备发送响应头时，调用 ngx_http_send_header(r)，内部会触发：
```
ngx_http_top_header_filter(r);
```
该函数指针会依次调用链上所有模块的头部过滤函数，直到某个函数返回错误或链结束。

模块自定义过滤函数：
每个模块的过滤函数通常如下结构：

static ngx_int_t ngx_http_foo_header_filter(ngx_http_request_t *r) {
    // 处理响应头...
    return ngx_http_next_header_filter(r); // 调用下一个过滤函数
}

假设有三个模块注册了头部过滤函数，链的顺序为：
A → B → C（通过模块初始化时的插入顺序决定）。
调用 ngx_http_top_header_filter(r) 的流程：

ngx_http_header_filter_module 模块的
postconfiguration 是
ngx_http_header_filter_init

static ngx_int_t
ngx_http_header_filter_init(ngx_conf_t *cf)
{
    ngx_http_top_header_filter = ngx_http_header_filter;

    return NGX_OK;
}

这里 ngx_http_top_header_filter 被赋值为 ngx_http_header_filter