nginx模块编程学习笔记3--模块主要数据结构

2012年10月31日 | 由 helight | 1200字 | 阅读大约需要3分钟 | 归档于 linux 应用 | 标签 #2pc #uwsgi

在nginx模块编写种主要会涉及到下面3个数据结构,这一篇我就先来看看这3个数据结构的作用和意义。

  1. ngx_command_t
  2. ngx_module_t
  3. ngx_http_module_t

前面这两个是定义在这个文件中:src/core/ngx_core.h

typedef struct ngx_module_s ngx_module_t;
typedef struct ngx_command_s     ngx_command_t;

两个结构体是在这个文件中定义的:src/core/ngx_conf_file.h

先看:ngx_command_s 这个结构体是用来保存组织配置文件中各个配置字段的。

struct ngx_command_s {
    ngx_str_t name;  //配置字段名称
    ngx_uint_t type; //类型和作用范围
    char *(*set)(ngx_conf_t *cf, ngx_command_t *cmd, void *conf); //设置或是读取函数
    ngx_uint_t conf; //配置域
    ngx_uint_t offset; //配置字段在配置结构体种的偏移量
    void *post; //暂时不知道做什么用
};

这里要提到的主要又这几个字段:type,set,conf,offset

type是标示这个配置字段的作用范围和参数设置,如:NGX_HTTP_MAIN_CONF|NGX_HTTP_SRV_CONF|NGX_HTTP_LOC_CONF|NGX_CONF_TAKE1,

这些宏是在src/http/ngx_http_config.h中定义的,首先nginx的配置文件的作用域又三个:main,server,local,分别指全局配置域,虚拟server配置域和localtion作用域,由大而小,所以在这里指定。

这里指定的还有一个就是这个配置字段有几个参数:

#define NGX_CONF_NOARGS 0x00000001 //没有参数
#define NGX_CONF_TAKE1 0x00000002 //一个参数
<
#define NGX_CONF_TAKE7 0x00000080 //7个参数

#define NGX_CONF_MAX_ARGS 8 //最大参数个数

set是一个函数指针,它主要从配置种返回这个命令字段的配置参数:

nginx系统提供了一些常用的设置函数

ngx_conf_set_flag_slot:针对于on和off这种标志处理
ngx_conf_set_str_slot: 对一般的字符串配置
ngx_conf_set_str_array_slot:对多参数处理
ngx_conf_set_keyval_slot:对于key-value类型参数处理
ngx_conf_set_num_slot:针对数字配置处理

这里还有好多,很多都没怎么用过

conf是nginx整体配置域的一个偏移量:

它的取值只有这样3个:

src/http/ngx_http_config.h

#define NGX_HTTP_MAIN_CONF_OFFSET offsetof(ngx_http_conf_ctx_t, main_conf)

#define NGX_HTTP_SRV_CONF_OFFSET offsetof(ngx_http_conf_ctx_t, srv_conf)

#define NGX_HTTP_LOC_CONF_OFFSET offsetof(ngx_http_conf_ctx_t, loc_conf)

ngx_http_conf_ctx_t结构体是这样的,

typedef struct {
    void **main_conf;
    void **srv_conf;
    void **loc_conf;
} ngx_http_conf_ctx_t;

这里的offsetof的一个gcc的一个宏,用来获取结构体内字段在结构体内的偏移量,和之前内核种常见的conten_of是一样的。原理:

#define  offsetof(s, m)   (size_t)&amp;(((s *)0)-&gt;m)

offset是配置字段在配置结构体中的偏移量:

例如我定义了这样一个配置段结构体:

typedef struct {
    ngx_str_t xlog_redis;
} ngx_log_redis_loc_conf_t;

那这里对xlog_redis配置的offset值就是offsetof(ngx_log_redis_loc_conf_t, xlog_redis)

看完本文有收获?请分享给更多人

关注「黑光技术」,关注大数据+微服务