开发一个HTTP过滤模块

浅浅的花香味﹌ 2022-08-07 04:53 127阅读 0赞

与HTTP处理模块不同，HTTP过滤模块的工作是对发送给用户的HTTP响应做一些加工。服务器返回的一个响应可以被任意多个HTTP过滤模块以流水线的方式依次处理。HTTP响应分为头部和包体，ngx\_http\_send\_header和ngx\_http\_output\_filter函数分别负责发送头部和包体，它们会依次调用各个过滤模块对待发送的响应进行处理。

HTTP过滤模块可以单独处理响应的头部或者包体或同时处理二者。处理头部和包体的方法原型分别如下，它们在HTTP框架模块ngx\_http\_core\_module.h中定义：

**\[cpp\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  // 过滤模块处理HTTP头部的方法原型  
2.  **typedef** ngx\_int\_t (\*ngx\_http\_output\_header\_filter\_pt)(ngx\_http\_request\_t \*r);  
3.     
4.  // 过滤模块处理HTTP包体的方法原型  
5.  **typedef** ngx\_int\_t (\*ngx\_http\_output\_body\_filter\_pt)(ngx\_http\_request\_t \*r, ngx\_chain\_t \*chain);

上面是两个函数指针的声明，HTTP过滤模块就是依赖这种指针串接成一个单链表的，每个HTTP过滤模块至少定义一个上述函数指针。入口链表如下所示：

**\[cpp\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  // HTTP过滤模块链表入口  
2.  **extern** ngx\_http\_output\_header\_filter\_pt  ngx\_http\_top\_header\_filter;  
3.  **extern** ngx\_http\_output\_body\_filter\_pt    ngx\_http\_top\_body\_filter;

当HTTP模块调用ngx\_http\_send\_header发送头部时，就从ngx\_http\_top\_header\_filter指向的模块开始遍历所有的HTTP头部过滤模块并处理；当HTTP模块调用ngx\_http\_output\_filter发送包体时，就从ngx\_http\_top\_body\_filter指向的模块开始遍历所有的HTTP包体过滤模块并处理。函数ngx\_http\_send\_header代码如下：

**\[cpp\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  ngx\_int\_t  
2.  ngx\_http\_send\_header(ngx\_http\_request\_t \*r)  
3.  \{  
4.      **if** (r->header\_sent) \{  
5.          ngx\_log\_error(NGX\_LOG\_ALERT, r->connection->log, 0,  
6.                        "header already sent");  
7.          **return** NGX\_ERROR;  
8.      \}  
9.     
10.     **if** (r->err\_status) \{  
11.         r->headers\_out.status = r->err\_status;  
12.         r->headers\_out.status\_line.len = 0;  
13.     \}  
14.    
15.     // 从头遍历HTTP头部过滤模块  
16.     **return** ngx\_http\_top\_header\_filter(r);  
17. \}

函数ngx\_http\_top\_header\_filter代码如下：

**\[cpp\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  ngx\_int\_t  
2.  ngx\_http\_output\_filter(ngx\_http\_request\_t \*r, ngx\_chain\_t \*in)  
3.  \{  
4.      ngx\_int\_t          rc;  
5.      ngx\_connection\_t  \*c;  
6.     
7.      c = r->connection;  
8.     
9.      ngx\_log\_debug2(NGX\_LOG\_DEBUG\_HTTP, c->log, 0,  
10.                    "http output filter \\"%V?%V\\"", &r->uri, &r->args);  
11.    
12.     // 遍历HTTP包体过滤模块  
13.     rc = ngx\_http\_top\_body\_filter(r, in);  
14.    
15.     **if** (rc == NGX\_ERROR) \{  
16.         /\* NGX\_ERROR may be returned by any filter \*/  
17.         c->error = 1;  
18.     \}  
19.    
20.     **return** rc;  
21. \}

在每个HTTP过滤模块中至少存在上述两种函数指针中的一个，声明如下：

**\[cpp\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **static** ngx\_http\_output\_header\_filter\_pt  ngx\_http\_next\_header\_filter;  
2.  **static** ngx\_http\_output\_body\_filter\_pt    ngx\_http\_next\_body\_filter;

加入HTTP过滤模块单链表的方法如下：

**\[cpp\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **static** ngx\_int\_t  
2.  ngx\_http\_addition\_filter\_init(ngx\_conf\_t \*cf)  
3.  \{  
4.      // 从头部加入  
5.      ngx\_http\_next\_header\_filter = ngx\_http\_top\_header\_filter;  
6.      ngx\_http\_top\_header\_filter = ngx\_http\_addition\_header\_filter;  
7.     
8.      // 从头部加入  
9.      ngx\_http\_next\_body\_filter = ngx\_http\_top\_body\_filter;  
10.     ngx\_http\_top\_body\_filter = ngx\_http\_addition\_body\_filter;  
11.    
12.     **return** NGX\_OK;  
13. \}

当本模块被初始化时，调用上述函数，将自己加入到链表头部。类似上面ngx\_http\_addition\_filter\_init这样的初始化函数在什么时候被调用呢？答案是依该方法放在ngx\_http\_module\_t结构体的哪个成员而定。一般而言，大多数官方HTTP过滤模块通常放在ngx\_http\_module\_t.postconfiguration函数指针中，读取完所有配置项后被回调。各个模块初始化的顺序是怎么样的呢？这由configure命令生成的ngx\_modules.c文件中的ngx\_modules数组的排列顺序决定。数组中靠前的模块先初始化。由于过滤模块是将自己插入到链表头部，使得ngx\_modules数组中过滤模块的排列顺序和它们实际执行的顺序相反。至于ngx\_modules数组中的排列顺序，又是由其它脚本决定的。

下面是开发一个简单的HTTP过滤模块的过程。

首先定义两个结构体：

**\[cpp\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **typedef** **struct**  
2.  \{  
3.      ngx\_flag\_t  enable;     // 保存on或者off  
4.  \} ngx\_http\_myfilter\_conf\_t;  
5.     
6.  **typedef** **struct**  
7.  \{  
8.      ngx\_int\_t  add\_prefix;  
9.  \} ngx\_http\_myfilter\_ctx\_t;  // HTTP上下文结构体

ngx\_http\_myfilter\_conf\_t用于保存标志是否开启过滤功能的配置项，这里我们使用预设的配置项解析方法对此配置项进行解析。ngx\_http\_myfilter\_ctx\_t则用于保存一个HTTP请求的上下文，因为HTTP包体的处理过程不是一次完成的，也就是说处理包体的函数会被调用多次，所以我们需要一个标志来记录当前是否已经由过滤模块进行过处理了。HTTP上下文相当于一张表，表中记录了该请求当前的处理记录。这样，当一个请求被拆分成多次处理时，同一个处理函数就能够了解该请求已经执行到哪里了，从而接着当前的进度进行处理。

HTTP模块结构ngx\_http\_module\_t定义如下：

**\[cpp\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **static** ngx\_http\_module\_t  ngx\_http\_myfilter\_module\_ctx =  
2.  \{  
3.      NULL,                             /\* preconfiguration \*/  
4.      ngx\_http\_myfilter\_init,           /\* postconfiguration \*/  
5.     
6.      NULL,                             /\* create\_main\_conf \*/  
7.      NULL,                             /\* init\_main\_conf \*/  
8.     
9.      NULL,                             /\* create\_srv\_conf \*/  
10.     NULL,                             /\* merge\_srv\_conf \*/  
11.    
12.     ngx\_http\_myfilter\_create\_conf,    /\* create\_loc\_conf \*/  
13.     ngx\_http\_myfilter\_merge\_conf      /\* merge\_loc\_conf \*/  
14. \};

三个函数借口的作用分别如下：

*  ngx\_http\_myfilter\_init：初始化该过滤模块，也就是将该模块插入到HTTP过滤模块单链表中，插入方法已经在上面介绍过了。
 *  ngx\_http\_myfilter\_create\_conf：给保存配置项的结构体ngx\_http\_myfilter\_conf\_t分配空间并初始化结构体成员
 *  ngx\_http\_myfilter\_merge\_conf：合并出现在main、srv级别的同名配置项

还有一个非常重要的结构ngx\_command\_t定义如下：

**\[cpp\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **static** ngx\_command\_t  ngx\_http\_myfilter\_commands\[\] =  
2.  \{  
3.      \{  
4.          ngx\_string("myfilter"),  
5.          NGX\_HTTP\_MAIN\_CONF | NGX\_HTTP\_SRV\_CONF | NGX\_HTTP\_LOC\_CONF | NGX\_HTTP\_LMT\_CONF | NGX\_CONF\_FLAG,  
6.          ngx\_conf\_set\_flag\_slot,     // 自带的解析函数  
7.          NGX\_HTTP\_LOC\_CONF\_OFFSET,  
8.          offsetof(ngx\_http\_myfilter\_conf\_t, enable),  
9.          NULL  
10.     \},  
11.     ngx\_null\_command  
12. \};

我们使用预设的配置项解析函数ngx\_conf\_set\_flag\_slot解析配置项myfilter，将解析出的配置项参数存入结构体ngx\_http\_myfilter\_conf\_t的enable成员中。配置项myfilter只能是“on”或者“off”。

注意，HTTP过滤模块仍然属于一个HTTP模块，也就是说：

ngx\_module\_t.type = NGX\_HTTP\_MODULE

下面是HTTP过滤模块的核心部分，即两个指针分别指向的函数。首先来看看处理HTTP响应头部的函数：

**\[cpp\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  // 处理请求的头部  
2.  **static** ngx\_int\_t ngx\_http\_myfilter\_header\_filter(ngx\_http\_request\_t \*r)  
3.  \{  
4.      ngx\_http\_myfilter\_ctx\_t   \*ctx;  
5.      ngx\_http\_myfilter\_conf\_t  \*conf;  
6.     
7.      //如果不是返回成功，这时是不需要理会是否加前缀的，直接交由下一个过滤模块  
8.      //处理响应码非200的情形  
9.      **if** (r->headers\_out.status != NGX\_HTTP\_OK)  
10.         **return** ngx\_http\_next\_header\_filter(r);  
11.    
12.     //获取http上下文  
13.     ctx = ngx\_http\_get\_module\_ctx(r, ngx\_http\_myfilter\_module);  
14.     **if** (ctx)  
15.         //该请求的上下文已经存在，这说明该模块已经被调用过1次，直接交由下一个过滤模块处理  
16.         **return** ngx\_http\_next\_header\_filter(r);  
17.    
18.     //获取存储配置项的ngx\_http\_myfilter\_conf\_t结构体  
19.     conf = ngx\_http\_get\_module\_loc\_conf(r, ngx\_http\_myfilter\_module);  
20.    
21.     //如果enable成员为0，也就是配置文件中没有配置add\_prefix配置项，  
22.     //或者add\_prefix配置项的参数值是off，这时直接交由下一个过滤模块处理  
23.     **if** (conf->enable == 0)  
24.         **return** ngx\_http\_next\_header\_filter(r);  
25.    
26.     //构造http上下文结构体ngx\_http\_myfilter\_ctx\_t  
27.     ctx = ngx\_pcalloc(r->pool, **sizeof**(ngx\_http\_myfilter\_ctx\_t));  
28.     **if** (ctx == NULL)  
29.         **return** NGX\_ERROR;  
30.    
31.     //add\_prefix为0表示不加前缀  
32.     ctx->add\_prefix = 0;  
33.    
34.     //将构造的上下文设置到当前请求中  
35.     ngx\_http\_set\_ctx(r, ctx, ngx\_http\_myfilter\_module);  
36.    
37.     //myfilter过滤模块只处理Content-Type是"text/plain"类型的http响应  
38.     **if** (r->headers\_out.content\_type.len >= **sizeof**("text/plain") - 1  
39.         && ngx\_strncasecmp(r->headers\_out.content\_type.data, (u\_char \*) "text/plain", **sizeof**("text/plain") - 1) == 0)  
40.     \{  
41.         ctx->add\_prefix = 1;    //1表示需要在http包体前加入前缀  
42.    
43.         //如果处理模块已经在Content-Length写入了http包体的长度，由于  
44.         //我们加入了前缀字符串，所以需要把这个字符串的长度也加入到  
45.         //Content-Length中  
46.         **if** (r->headers\_out.content\_length\_n > 0)  
47.             r->headers\_out.content\_length\_n += filter\_prefix.len;  
48.     \}  
49.    
50.     //交由下一个过滤模块继续处理  
51.     **return** ngx\_http\_next\_header\_filter(r);  
52. \}

这里有几点要注意。当该模块遇到错误的响应或模块本身出错时，不应该退出程序而是应该交由下一个HTTP过滤模块处理，这就是上述代码中多次调用ngx\_http\_next\_header\_filter函数的原因。还有就是函数首先要判断在配置文件中是否打开此过滤功能并检查响应的类型。流程图如下：

![SouthEast][]

接下来是处理HTTP包体的函数：

**\[cpp\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  //将在包体中添加这个前缀  
2.  **static** ngx\_str\_t filter\_prefix = ngx\_string("~~~~~~~This is a prefix~~~~~~~\\n");  
3.     
4.  // 处理请求的包体  
5.  **static** ngx\_int\_t ngx\_http\_myfilter\_body\_filter(ngx\_http\_request\_t \*r, ngx\_chain\_t \*in)  
6.  \{  
7.      ngx\_http\_myfilter\_ctx\_t  \*ctx;  
8.      
9.      // 获得HTTP上下文  
10.     ctx = ngx\_http\_get\_module\_ctx(r, ngx\_http\_myfilter\_module);  
11.     
12.     //如果获取不到上下文，或者上下文结构体中的add\_prefix为0或者2时，  
13.     //都不会添加前缀，这时直接交给下一个http过滤模块处理  
14.     **if** (ctx == NULL || ctx->add\_prefix != 1)  
15.         **return** ngx\_http\_next\_body\_filter(r, in);  
16.     
17.     //将add\_prefix设置为2，这样即使ngx\_http\_myfilter\_body\_filter再次回调时，也不会重复添加前缀  
18.     ctx->add\_prefix = 2;  
19.     
20.     //从请求的内存池中分配内存，用于存储字符串前缀  
21.     ngx\_buf\_t\* b = ngx\_create\_temp\_buf(r->pool, filter\_prefix.len);  
22.     
23.     //将ngx\_buf\_t中的指针正确地指向filter\_prefix字符串  
24.     b->start = b->pos = filter\_prefix.data;  
25.     b->last = b->pos + filter\_prefix.len;  
26.     
27.     //从请求的内存池中生成ngx\_chain\_t链表，将刚分配的ngx\_buf\_t设置到  
28.     //其buf成员中，并将它添加到原先待发送的http包体前面  
29.     ngx\_chain\_t \*cl = ngx\_alloc\_chain\_link(r->pool);  
30.     cl->buf = b;  
31.     cl->next = in;  
32.     
33.     //调用下一个模块的http包体处理方法，注意这时传入的是新生成的cl链表  
34.     **return** ngx\_http\_next\_body\_filter(r, cl);  
35. \}

根据这一句cl->next = in可以判断，我们将filter\_prefix包含的字符串添加到了HTTP响应包体的前面。以上函数的流程图如下：

![SouthEast 1][]

下面是编译及演示过程。我们在第一个mytest模块的基础上对发送的信息添加前缀。为了把两个模块同时编译进nginx，我们在config时输入如下命令：

**\[cpp\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  ./configure --add-module="/work/nginx/modules/mytest /work/nginx/modules/myfilter"

然后检查是否成功包含了两个模块，这里我们可以查看保存所有模块的数组ngx\_modules\[\]：

**\[cpp\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  vim objs/ngx\_modules.c

结果如下：

![SouthEast 2][]

可以看到，HTTP模块mytest和HTTP过滤模块myfilter都被包含进来了。接下来就是make和make install了。安装成功后，我们还要修改配置文件：

**\[cpp\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  vim /usr/local/nginx/conf/nginx.conf

配置文件修改后如下图所示：

![SouthEast 3][]

当客户端输入的URI为/nestle时，就会启动mytest和myfilter两个模块，运行结果如下所示：

![SouthEast 4][]

可以看到，HTTP过滤模块成功的在响应包体的内容前面添加了我们预设的字符串。

整个HTTP过滤模块的完整代码如下：

**\[cpp\]**  [view plain][] [copy][view plain] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  \#include <ngx\_config.h>  
2.  \#include <ngx\_core.h>  
3.  \#include <ngx\_http.h>  
4.    
5.   // 配置项结构体  
6.  **typedef** **struct** \{  
7.      ngx\_flag\_t enable;  
8.  \} ngx\_http\_myfilter\_conf\_t;  
9.    
10. // 上下文结构体  
11. **typedef** **struct** \{  
12.     ngx\_int\_t add\_prefix;  
13. \} ngx\_http\_myfilter\_ctx\_t;  
14.   
15. ngx\_module\_t ngx\_http\_myfilter\_module;  // 前向声明  
16.   
17. **static** ngx\_http\_output\_header\_filter\_pt ngx\_http\_next\_header\_filter;  
18. **static** ngx\_http\_output\_body\_filter\_pt ngx\_http\_next\_body\_filter;  
19.   
20. // 需要添加的前缀内容  
21. **static** ngx\_str\_t filter\_prefix = ngx\_string("~~~~~~~This is a prefix~~~~~~~\\n");  
22.   
23. **static** ngx\_int\_t ngx\_http\_myfilter\_header\_filter(ngx\_http\_request\_t \*r)  
24. \{  
25.     ngx\_http\_myfilter\_ctx\_t  \*ctx;  
26.     ngx\_http\_myfilter\_conf\_t \*conf;  
27.   
28.     **if** (r->headers\_out.status != NGX\_HTTP\_OK)  
29.         **return** ngx\_http\_next\_header\_filter(r);  // 交由下一个过滤模块处理  
30.   
31.     ctx = ngx\_http\_get\_module\_ctx(r, ngx\_http\_myfilter\_module);  
32.     **if** (ctx)  
33.         **return** ngx\_http\_next\_header\_filter(r);  // 上下文已存在，不再处理  
34.   
35.     conf = ngx\_http\_get\_module\_loc\_conf(r, ngx\_http\_myfilter\_module);   // 获取配置项结构体  
36.     **if** (conf->enable == 0)  
37.         **return** ngx\_http\_next\_header\_filter(r);  // 此过滤模块未打开  
38.   
39.     ctx = ngx\_pcalloc(r->pool, **sizeof**(ngx\_http\_myfilter\_ctx\_t)); // 创建上下文结构体  
40.     **if** (ctx == NULL)  
41.         **return** NGX\_ERROR;  
42.   
43.     ctx->add\_prefix = 0; // 0表示不需要添加前缀  
44.     ngx\_http\_set\_ctx(r, ctx, ngx\_http\_myfilter\_module);  
45.   
46.     // 只处理Content-Type为text/plain类型的HTTP请求  
47.     **if** (r->headers\_out.content\_type.len >= **sizeof**("text/plain")-1 &&  
48.         ngx\_strncasecmp(r->headers\_out.content\_type.data, (u\_char \*)"text/plain", **sizeof**("text/plain")-1) == 0)  
49.     \{  
50.             ctx->add\_prefix = 1; // 1表示需要加入前缀  
51.             **if** (r->headers\_out.content\_length\_n > 0)  
52.                 r->headers\_out.content\_length\_n += filter\_prefix.len;    // 响应包体长度增加  
53.     \}  
54.   
55.     **return** ngx\_http\_next\_header\_filter(r);  
56. \}  
57.   
58. **static** ngx\_int\_t ngx\_http\_myfilter\_body\_filter(ngx\_http\_request\_t \*r, ngx\_chain\_t \*in)  
59. \{  
60.     ngx\_http\_myfilter\_ctx\_t  \*ctx;  
61.   
62.     ctx = ngx\_http\_get\_module\_ctx(r, ngx\_http\_myfilter\_module); // 获取上下文结构体  
63.     **if** (ctx == NULL || ctx->add\_prefix != 1)  
64.         **return** ngx\_http\_next\_body\_filter(r, in);    // 不添加前缀  
65.   
66.     ctx->add\_prefix = 2; // 2表示已添加前缀  
67.   
68.     ngx\_buf\_t \*b = ngx\_create\_temp\_buf(r->pool, filter\_prefix.len);  
69.     b->start = b->pos = filter\_prefix.data;  
70.     b->last = b->pos + filter\_prefix.len;  
71.   
72.     // 链入待发送包体头部  
73.     ngx\_chain\_t \*cl = ngx\_alloc\_chain\_link(r->pool);  
74.     cl->buf = b;  
75.     cl->next = in;  
76.   
77.     **return** ngx\_http\_next\_body\_filter(r, cl);    // 跳到下一个过滤模块  
78. \}  
79.   
80. // 初始化HTTP过滤模块  
81. **static** ngx\_int\_t ngx\_http\_myfilter\_init(ngx\_conf\_t \*cf)  
82. \{  
83.     ngx\_http\_next\_header\_filter = ngx\_http\_top\_header\_filter;     
84.     ngx\_http\_top\_header\_filter = ngx\_http\_myfilter\_header\_filter;  
85.   
86.     ngx\_http\_next\_body\_filter = ngx\_http\_top\_body\_filter;  
87.     ngx\_http\_top\_body\_filter = ngx\_http\_myfilter\_body\_filter;  
88.   
89.     **return** NGX\_OK;  
90. \}  
91.   
92. // 创建存储配置项的结构体  
93. **static** **void**\* ngx\_http\_myfilter\_create\_conf(ngx\_conf\_t \*cf)  
94. \{  
95.     ngx\_http\_myfilter\_conf\_t \*mycf;  
96.   
97.     mycf = (ngx\_http\_myfilter\_conf\_t \*)ngx\_pcalloc(cf->pool, **sizeof**(ngx\_http\_myfilter\_conf\_t));  
98.     **if** (mycf == NULL)  
99.         **return** NULL;  
100.   
101.     mycf->enable = NGX\_CONF\_UNSET;  
102.     **return** mycf;  
103. \}  
104.   
105. // 合并配置项  
106. **static** **char**\* ngx\_http\_myfilter\_merge\_conf(ngx\_conf\_t \*cf, **void** \*parent, **void** \*child)  
107. \{  
108.     ngx\_http\_myfilter\_conf\_t \*prev = (ngx\_http\_myfilter\_conf\_t \*)parent;  
109.     ngx\_http\_myfilter\_conf\_t \*conf = (ngx\_http\_myfilter\_conf\_t \*)child;  
110.   
111.     ngx\_conf\_merge\_value(conf->enable, prev->enable, 0);  // 合并函数  
112.   
113.     **return** NGX\_CONF\_OK;  
114. \}  
115.   
116. **static** ngx\_command\_t ngx\_http\_myfilter\_commands\[\] = \{  
117.     \{  
118.         ngx\_string("myfilter"),  
119.         NGX\_HTTP\_MAIN\_CONF | NGX\_HTTP\_SRV\_CONF | NGX\_HTTP\_LOC\_CONF | NGX\_HTTP\_LMT\_CONF | NGX\_CONF\_FLAG,  
120.         ngx\_conf\_set\_flag\_slot,  
121.         NGX\_HTTP\_LOC\_CONF\_OFFSET,  
122.         offsetof(ngx\_http\_myfilter\_conf\_t, enable),  
123.         NULL,  
124.     \},  
125.     ngx\_null\_command  
126. \};  
127.    
128.   
129. // HTTP框架初始化时调用的八个函数  
130. **static** ngx\_http\_module\_t ngx\_http\_myfilter\_module\_ctx = \{  
131.     NULL,  
132.     ngx\_http\_myfilter\_init,  
133.     NULL,  
134.     NULL,  
135.     NULL,  
136.     NULL,  
137.     ngx\_http\_myfilter\_create\_conf,  
138.     ngx\_http\_myfilter\_merge\_conf,  
139. \};  
140.    
141. // 定义一个HTTP模块  
142. ngx\_module\_t ngx\_http\_myfilter\_module = \{  
143.     NGX\_MODULE\_V1,  // 0,0,0,0,0,0,1  
144.     &ngx\_http\_myfilter\_module\_ctx,  
145.     ngx\_http\_myfilter\_commands,  
146.     NGX\_HTTP\_MODULE,  
147.     NULL,  
148.     NULL,  
149.     NULL,  
150.     NULL,  
151.     NULL,  
152.     NULL,  
153.     NULL,  
154.     NGX\_MODULE\_V1\_PADDING,  // 0,0,0,0,0,0,0,0,保留字段  
155. \};  
156.

[view plain]: http://blog.csdn.net/nestler/article/details/36663043?utm_source=tuicool#
[CODE]: https://code.csdn.net/assets/CODE_ico.png
[CODE_CODE]: https://code.csdn.net/snippets/415362
[ico_fork.svg]: https://code.csdn.net/assets/ico_fork.svg
[ico_fork.svg 1]: https://code.csdn.net/snippets/415362/fork
[SouthEast]: /images/20220805/ab95990be8c14ef29db0e87f8729bdce.png
[SouthEast 1]: /images/20220805/a005b2bcd7bd4754a641003a69d1a34b.png
[SouthEast 2]: /images/20220805/345e0a56d2d54804b813c1bc78454989.png
[SouthEast 3]: /images/20220805/bbaecf162e7a4ef1bf233fdb9d93faf6.png
[SouthEast 4]: /images/20220805/45c1a4f8d9cc49c5af5155e7a078821b.png