nginx-http模块的数据结构
来源:互联网 发布:无限极网络电视盒 编辑:程序博客网 时间:2024/05/22 06:15
在编写HTTP第三方模块时,需要了解nginx中HTTP模块的数据结构
定义HTTP模块方式很简单
ngx_module_t ngx_http_mytest_module;
就是这么简单,
下面先分析一下nginx模块中的所有成员:
typedef struct ngx_module_s ngx_module_t;struct ngx_module_s{ //分别赋值ctx_index.index.spare0.spare2.sapre3.version #define NGX_MODULE_V1 0,0,0,0,0,0,1 //同一类模块的序号,有管理这类模块的nginx核心模块设置。很重要。因为nginx模块依赖于顺序。 ngx_uint_t ctx_index; /*nginx启动时根据ngx_modules数组设置各模块的index值 ngx_max_module = 0; for(i = 0; ngx_modules[i];i++) { ngx_modules[i]->index = ngx_max_module++; } */ //index表示当前模块在ngx_modules中的序号 ngx_uint_t index; //spare系列保留变量,暂时没有使用 ngx_uint_t spare0; ngx_uint_t spare1; ngx_uint_t spare2; ngx_uint_t spare3; //模块的版本号 ngx_unit_t version; //用于指向一类模块的上下文结构体。ctx指向特定类型模块的公共接口 //例:http模块中,ctx指向ngx_http_module_t结构体 void *ctx; //nginx.conf配置项 ngx_command_t *command; //表示模块类型。与ctx相关。 //5种取值。NGX_HTTP_MODULE.NGX_CORE_MODULE,NGX_CONF_MODULE.NGX_EVENT_MODULE //NGX_MAIL_MODULE ngx_uint_t type; //下面是7个函数指针表示有7个执行点会分别调用这7种方法。 //1.启动时回调init_master ngx_int_t (*init_master)(ngx_log_t *log); //2.init_module初始化所有模块时被调用。master/worker模式,在启动worker子进程前完成 ngx_int_t (init_module)(ngx_cycle_t *cycle); //3.正常服务前被调用,master/worker模式,多个worker已经残生,每个worker初始化会调用 ngx_int_t (init_process)(ngx_cycle_t *cycle); //4.这个可以忽视,就是代表多线程模式的初始化,Nginx不支持多线程。1.015版本是这样,后面不清楚 ngx_int_t (init_thread)(ngx_cycle_t *cycle); //5.同上 void (*exit_thread)(ngx_cycle_t *cycle); //6.服务停止前调用,worker进程在退出前调用 void (*exit_process)(ngx_cycle_t *cycle); //7.master进程退出前调用 void (*exit_master)(ngx_cycle_t *cycle); //保留字段,可以使用NGX_MODULE_V1_PADDING填充,同第一个 uintprt_t spare_hook0; uintprt_t spare_hook1; uintprt_t spare_hook2; uintprt_t spare_hook3; uintprt_t spare_hook4; uintprt_t spare_hook5; uintprt_t spare_hook6; uintprt_t spare_hook7; };
ps:定义一个HTTP模块时,type字段必须设置为NGX_HTTP_MODULE;
ngx_module_t 中的ctx必须指向ngx_http_module_t接口。
-------------------------------------------------------------------------------------------
下面来解释一下ngx_http_module_t结构,他描述了HTTP矿在在读取。重载配置是定义的8个阶段。启动过程中调用。NULL则不调用
typedef struct{ //解析配置文件前调用 ngx_int_t (*preconfiguration)(ngx_conf_t *cf); //完成配置文件的解析后调用 ngx_int_t (*postconfiguration)(ngx_conf_t *cf); //创建数据结构用于存储只属于http{...}块的全局配置项。 void* (*create_main_conf)(ngx_conf_t *cf); //初始化上面这个 char* (*init_main_conf)(ngx_conf_t *cd,void *conf); //srv级别(server{...}快)配置项 void* (*create_srv_conf)(ngx_conf_t *cf); //合并main/srv级别下的同名配置项 char* (*merge_srv_conf)(ngx_conf_t *cd,void *prev,void* conf); //loc级别(location{...}快)配置项 void* (*create_loc_conf)(ngx_conf_t *cf); //合并loc/srv级别下的同名配置项 char* (*merge_srv_conf)(ngx_conf_t *cd,void *prev,void* conf);}
ps:回调方法与内部无关,与nginx.conf配置项有关。
-------------------------------------------------------------------------------------------
这里在提一个概念,commadns数组(元素为ngx_command_t)。用于定义模块的配置文件。ngx解析配置文件中的一个配置项首先会遍历所有模块,对于一个模块而言,通过遍历commands数组进行,ngx_null_command为结束。
typedef struct ngx_command_s ngx_commadn_t;struct ngx_command_s{ //配置项名称,如“gzip” ngx_str_t name; //配置项类型,制定出现位置,以及可以携带的参数个数 ngx_uint_t type; //出现了Name中指定的配置项后,将会调用set处理配置项的参数 char* (*set)(ngx_conf_t *cf,ngx_command_t *cmd,void* conf); //配置文件中的偏移量 ngx_uint_t conf; //使用预设的解析方法解析配置项 ngx_uint_t offset; //配置项读取后的处理方法,必须是ngx_conf_post_t结构的指针 void *post;}ngx_null_command为一个空的ngx_command_t.#define ngx_null_command {ngx_null_string,0,NULL,0,0,NULL}
以上
本文出自 “剩蛋君” 博客,转载请与作者联系!
0 0
- nginx-http模块的数据结构
- Nginx的HTTP模块介绍-----数据结构部分
- Nginx的HTTP Access模块
- nginx的HTTP模块编写
- nginx的HTTP模块编写
- Nginx模块-简单的HTTP模块
- 13 Nginx的标准http模块
- 【Nginx】开发一个简单的HTTP模块
- nginx HTTP模块的hello world
- Nginx HTTP模块的配置项管理
- Nginx 定义自己的 http 模块
- nginx 开发简单的http模块
- 【Nginx】编译进去自己的HTTP模块
- Nginx 定义自己的 http 模块
- Nginx Http模块开发
- Nginx Http模块开发
- nginx---HTTP模块
- nginx HTTP模块组成
- cookie和session
- HTTP:HTTP状态码
- Manacher 模板
- 设计模式之单例模式:singleton
- java File类
- nginx-http模块的数据结构
- 动态代理两种实现方式
- 判断一棵树
- 51nod 浮波那契(构造矩阵+矩阵快速幂)
- 树:二叉树的前序/中序/后序/层次递归
- 树:二叉树的公共祖父节点
- 数据结构:图的代码
- 布隆过滤器:实现代码
- JavaScript中‘this’关键词的优雅解释