ngxin的Module开发（2）

nginx的module开发很弱，首先它不是采用动态库的形式被主进程加载，而是要求module的源码必须和nginx的源码一起编译。我是第一次见到这么BT的家伙，呵呵。所以呢，对module开发者来说，nginx就是一个开发平台，可以把它理解为在nginx这个“OS”上用C语言开发application，而且要遵循nginx的框架。

既然是平台，那么像其他OS一样，我们需要搞明白几点：1、程序入口和调用方式。2、HTTP处理框架。3、对Http body的处理。4、Upstream机制。5、内存使用。6、配置文件的使用。7、LOG的API。

 

1、先要搞明白程序入口，就像在LINUX上写可执行程序会自动去找main方法一样。下面我会用一个例子来说明一下处理流程。

nginx的程序入口先要在module所在目录的config文件里配置，类似：

USE_SHA1=YES

ngx_addon_name=ngx_XXX_module

HTTP_MODULES="$HTTP_MODULES ngx_XXX_module"

NGX_ADDON_SRCS="$NGX_ADDON_SRCS $ngx_addon_dir/ngx_XXX_module.

 

同时在module源文件中，定义如下结构：

static ngx_command_t ngx_XXX_commands[] = {

 {

   ngx_string("XXX"),

   NGX_HTTP_LOC_CONF|NGX_CONF_NOARGS,

   ngx_XXX_init,

   0,

   0,

   NULL

 }

};

 

static ngx_http_module_t ngx_XXX_module_ctx = {

   NULL, //ngx_XXX_add_variables,         /* preconfiguration */

   NULL,                                  /* postconfiguration */

 

   NULL,                                  /* create main configuration */

   NULL,                                  /* init main configuration */

 

   NULL,                                  /* create server configuration */

   NULL,                                  /* merge server configuration */

 

   ngx_XXX_create_loc_conf,       /* create location configuration */

   ngx_XXX_merge_loc_conf         /* merge location configuration */

};

 

 

ngx_module_t ngx_XXX_module = {

 NGX_MODULE_V1,

 &ngx_XXX_module_ctx,

 ngx_XXX_commands,

 NGX_HTTP_MODULE,

 NULL,

 NULL,

 NULL,

 NULL,

 NULL,

 NULL,

 NULL,

 NGX_MODULE_V1_PADDING

};

那么，nginx主进程在启动时，就会在执行代码里找相应的ngx_module_t（ngx_XXX_module）变量，找到后，在其中ngx_command_t（ngx_XXX_commands）指定的函数ngx_XXX_init里开始初始化模块。所有的工作都要在这里进行了，包括后续对每个请求的处理订阅。

 

Nginx启动时，会先启动一个master管理进程，然后根据配置启动数个worker进程。实际的module里的勾子函数（例如ngx_XXX_handle），都是被worker进程所调用的。默认情况下，nginx并不是多线程的，所以，如果你的勾子函数被调用了，那么你绝对不可以有任何阻塞操作，否则会使得nginx worker不去处理已经在链表中的其他connection，这就完全毁了nginx，如果你去同步请求硬盘IO资源，否则其他SERVER的网络IO，那么它和apach+CGI这种低性能SERVER也没啥两样了，除了epoll可以hold住大量连接。