【Nginx】如何使用http配置

处理http配置项可以分为下面4个步骤：

1）创建数据结构用于存储配置项对应的参数

2）设定配置项在nginx.conf中出现时的限制条件与回调方法

3）实现第2步中的回调方法，或者使用Nginx框架预设的14个回调方法

4）合并不同级别的配置块中出现的同名配置项

一、分配用于保存配置参数的数据结构

创建结构体(命名例子：ngx_http_mytest_conf_t)来存储配置项的参数值，使用ngx_http_module_t中的create_main_conf，create_srv_conf、create_loc_conf这三个回调方法把我们分配的用于保存配置项的结构体传递给http框架，即生成结构体。

使用结构体来存储配置项的参数值的原因：多个location块（http块、server块）中的相同配置项是允许同时生效的，即刚刚定义的结构体在Nginx的内存中会保存许多份，所以不能使用全局变量。

定义三个回调方法的原因：

http框架定义了3个级别的配置main、srv、loc，分别表示直接出现在http{}、server{}、location{}块内的配置项。当遇到http{}配置块时，http框架会调用以上三个方法；当遇到server{}块时会再次调用所有http模块的create_srv_conf,create_loc_conf回调方法；当遇到location{}时会调用create_loc_conf回调方法。

一个create_loc_conf方法的例子：

static void *ngx_http_mytest_create_loc_conf(ngx_conf_t *cf)

{

　　ngx_http_mytest_conf_t *mycf;

　　mycf=(ngx_http_mytest_conf_t *)ngx_pcalloc(cf->pool,sizeof(ngx_http_mytest_conf_t));

　　if(mycf==NULL)

　　　　return NULL:

　　mycf->test_flag=NGX_CONF_UNSET;

　　mycf->test_num=NGX_CONF_UNSET;

　　//...类似上面的赋值

　　return mycf;

}

二、设定配置项的解析方法

使用ngx_command_t结构来配置配置项：

struct ngx_command_s

{

　　ngx_str_t name;//配置项名称

　　ngx_uint_t type;//决定配置项可以在哪些块出现，以及可以携带的参数类型和个数

　　char *(*set)(ngx_conf_t *cf,ngx_command_t *cmd,void *conf);//使用14种预设方法解析配置项

　　ngx_uint_t conf;

　　ngx_uint_t offset;

　　void *post;

}ngx_command_t;

例子：使用14种预设的方法解析配置项

假设nginx.conf中有个配置项名称为test_flag,后面携带一个参数，取值必须是on或者off，故使用ngx_http_mytest_conf_t结构体中的ngx_flag_t my_flag成员来保存。

static ngx_command_t ngx_http_mytest_commands[]=

{

　　ngx_string("test_flag"),

　　NGX_HTTP_LOC_CONF|NGX_CONF_FLAG,

　　ngx_conf_set_flag_slot,//预设方法

　　NGX_HTTP_LOC_CONF_OFFSET,

　　offsetof(ngx_http_mytest_conf_t,my_flag),

　　NULL},

　　ngx_null_command

};

三、自定义配置项处理方法

先自定义结构体存储配置项参数值，再编写set方法。

四、合并配置项

调用ngx_http_module_t结构体中的merge_loc_conf方法，如何合并取决于具体的merge_loc_conf实现