nginx module 开发谈(2)

最后更新于:2022-04-01 14:47:46

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