nginx 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住大量连接。