ginx模块定制开发中，大多数都是针对http的模块的定制开发，比如添加一个打印“hello world”的功能、记录http请求内容、对http请求作出一个特殊响应等，此时，需要在nginx源码中的http模块中介入我们的定制代码，我们可以通过必定会被调用的postconfiguration方法，向全局的ngx_http_core_main_conf_t结构的phases[NGX_HTTP_LOG_PHASE+ 1] 添加handler

nginx的HTTP请求分为11个阶段，具体可参考​​NGINX中HTTP请求的11个处理阶段​​

此处我们选择在倒数第二个阶段NGX_HTTP_CONTENT_PHASE中介入




[cpp]  ​​view plain​​​  ​​​copy​​





  1. static ngx_http_module_t ngx_http_test_module_ctx = {
  2. NULL,                           /* preconfiguration */
  3. ngx_http_test_init,            /* postconfiguration */
  4. NULL,                           /* create main configuration. */
  5. NULL,                           /* init main configuration. */
  6. NULL,                           /* create server configuration. */
  7. NULL,                           /* merge server configuration. */
  8. ngx_http_test_create_loc_conf, /* create location configuration. */
  9. NULL                            /* merge location configuration. */
  10. };
  11. ngx_module_t ngx_http_test_module = {
  12. NGX_MODULE_V1,
  13. &ngx_http_test_module_ctx, /*module context*/
  14. ngx_http_test_commands,    /*module directives*/
  15. NGX_HTTP_MODULE,            /*module type*/
  16. NULL,                       /*init master*/
  17. NULL,                       /*init module*/
  18. NULL,                       /*init process*/
  19. NULL,                       /*init thread*/
  20. NULL,                       /*exit thread*/
  21. NULL,                       /*exit process*/
  22. NULL,                       /*exit master*/
  23. NGX_MODULE_V1_PADDING
  24. };
  25. static ngx_int_t ngx_http_test_init(ngx_conf_t *cf)
  26. {
  27. ngx_http_handler_pt        *w;
  28. ngx_http_handler_pt        *h;
  29. ngx_http_core_main_conf_t  *cmcf;
  30. cmcf = (ngx_http_core_main_conf_t*)ngx_http_conf_get_module_main_conf(cf, ngx_http_core_module);
  31. //在NGX_HTTP_CONTENT_PHASE中介入处理代码，回调函数ngx_http_test_handler可对http请求做处理
  32. w = (ngx_http_handler_pt*)ngx_array_push(&cmcf->phases[NGX_HTTP_CONTENT_PHASE].handlers);
  33. if (w == NULL)
  34. {
  35. return NGX_ERROR;
  36. }
  37. //具体实现的回调函数
  38. *w = ngx_http_test_handler;
  39. //NGX_HTTP_LOG_PHASE中介入的回调函数用来记录日志
  40. h = (ngx_http_handler_pt*)ngx_array_push(&cmcf->phases[NGX_HTTP_LOG_PHASE].handlers);
  41. if (h == NULL)
  42. {
  43. return NGX_ERROR;
  44. }
  45. //具体实现的回调函数
  46. *h = ngx_http_test_logger;
  47. return NGX_OK;
  48. }




NGX_HTTP_CONTENT_PHASE阶段

这是一个核心HTTP阶段，大部分HTTP模块都会在此阶段重新定义Nginx服务器的行为，主要原因如下：

1、ngx_http_phases中的前9个阶段主要专注4件基础工作，rewrite重写URL、找到location配置块、判断请求是否具备访问权限、try_files功能优先读取静态资源文件，这4个工作通常适用于绝大部分请求，因此，许多HTTP模块可以共享这9个阶段中以及完成的功能。

2、NGX_HTTP_CONTENT_PHASE阶段与其他阶段都不同的是，它向HTTP模块提供了两种介入该阶段的方式：第一种与其他10个阶段一样，通过向全局ngx_http_core_main_conf_t结构体的phases数组中添加ngx_http_handler_pt处理方法来实现，而第二种是此阶段独有的，把希望处理请求的ngx_http_handler_pt方法设置到location相关的ngx_http_core_loc_conf_t结构体的handler指针中。

上面说的第一种方式，是通过在必定会被调用的postconfiguration方法向全局的ngx_http_core_main_conf_t结构体的phases[NGX_HTTP_LOG_PHASE+ 1]动态数组添加ngx_http_handler_pt处理方法来达成，此处理方法应用于全部的HTTP请求。

第二种方式通过设置ngx_core_loc_conf_t结构体的handler指针来实现，每一个location都对应一个独立的ngx_core_loc_conf_t结构体，可以选择在ngx_command_t的某个配置项的回调函数中添加处理方法，将当前location块所属的ngx_http_core_loc_conf_t结构体中的handler设置为ngx_http_handler_pt处理方法。这样做的好处是，ngx_http_handler_pt处理方法不再应用于所有的HTTP请求，仅仅当用户请求的URI匹配了location时才会被调用。