nginx HTTPモジュールの構成

元のリンク: http://cjhust.blog.163.com/blog/static/17582715720124544047608/

1、データ構造

ngx_conf_s

struct ngx_conf_s {

char *args; //

コマンドパラメータ、ファイルから読み取ってこの配列に入れる

ngx_cycle_t *cycle; //

はシステムパラメータを指します

ngx_pool_t *temp_pool; ngx_log_t *ログ;

void //(void ****)cycle->conf_ctx

、これにはすべてのモジュールの構成情報が含まれます

ngx_uint_t module_type; // 現在の命令を処理するモジュールのタイプ

ngx_uint_t cmd_type; このコマンドを処理する コマンドの種類

ngx_conf_handler_pt ハンドラー; //コマンド処理関数

char上記のhandlerを使用すると、ngx_conf_sは橋。

ngx_http_conf_ctx_t

typedef struct {

void **main_conf;

void **srv_conf;

void **loc_conf;

} ngx_http_conf_ctx_t;

备注： HTTP ブロック 内の構成構造主に3中、メイン、サーバー{}、の場所{}。

ngx_http_module_t

typedef struct {

ngx_int_t (*事前設定)(ngx_ conf_t *cf);

ngx_int_t (*構成後)(ngx_conf_t * cf);

void *(*create_main_conf)(ngx_conf_t *cf);

char *(*init_main_conf)(ngx_conf_t *cf, void *conf);

void *(*create_srv_conf)(ngx_conf_t *cf);

char *(*merge_s rv_conf)(ngx_conf_t *cf, void *prev, void *conf);

void *(*create_loc_conf)(ngx_conf_t *cf);

char *(*merge_loc_ conf)(ngx_conf_t *cf, void *prev, void *conf);

} ngx_http_module_t;

备注：HTTPモデ块中のctx主要有上は8の関数数で構成されています。

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;

};

#define ngx_null_command { ngx_null_string, 0, NULL, 0、0、NULL }

2、HTTP ctx

2.1 create_main_conf(ngx_conf_t *cf)

パラメータ: ngx_conf_t *cf、構成構造。

戻り値: + gx_http _get_module_ main _conf; の結果:

例: static void * ngx_http_barrier_create_conf(ngx_conf_t *cf) { ngx_http_barrier_conf_t *conf; / /カスタム構造

conf = ngx_pcalloc(cf->pool, sizeof(ngx_http_barrier_conf_t)) //pcalloc によって初期化 if (conf == NULL) {

return NULL;

}

conf->enable = NGX_CONF_UNSET;

return conf; //

カスタム構造を返す

}

2.2 create_srv_conf(ngx_conf_t *cf)

パラメータ:

ngx_conf_t *cf、構成構造体。

戻り値:

void *

;

注: 戻り値は x_http として使用できます。 _get_module_ srv_conf; の結果:

static void * ngx_http_barrier_create_conf(ngx_conf_t *cf) { ngx_http_barrier_conf_t *conf; / カスタマイズされた構造

conf = ngx_pcalloc(cf->pool, sizeof(ngx_http_barrier_conf_t)) //pcalloc if (conf == NULL) { N null を返す; CONF- & GT; enable = ngx_conf_unset; // カスタム構造体に戻ります

}}

2.3 create_loc_conf(ngx_conf_t *cf)

パラメータ: ngx_conf_t *cf、構成構造体。

戻り値:

void *

;

注:

戻り値は

ngx_http_conf_get_module_loc_conf

および

gx_http として使用できます。 _get_module_loc_conf の結果;

例:

static void * ngx_http_barrier_create_conf(ngx_conf_t *cf)

{ ngx_http_barrier_conf_t *conf; カスタマイズされた構造

conf = ngx_pcalloc(cf->pool, sizeof(ngx_http_barrier_conf_t)); //pcalloc で初期化

if (conf == NULL) {

return NULL;

}

conf->enable = NGX_CONF_UNSET;

return conf; //カスタムに戻る

}の構造

2.4事前設定(ngx_conf_t * cf )

パラメータ:

ngx_conf_t *cf、構成構造体戻り値:

ngx _int_t ； 備考:

戻り値は、操作が正しいかどうかの判断としてのみ使用されます。例:

static ngx_int_t

ngx_http _ssl_add _variables(ngx_conf_t *cf)

{

ngx_http_variable_t *var, *v;

for (v = ngx_http_ssl_vars; v->name.len; v++) {

var = ngx_http_add_variable(cf 、&v->名前、v->フラグ);

if (var == NULL) {

var->get_handler = v->gt ;get_handler;

var->data = v->data;

}

return NGX_OK;

}

2.5 init_main_conf(ngx_conf_t *cf, void *conf )

パラメータ:

ngx_conf_t *cf と

conf、conf create_main 戻り値はパラメータはここにあります。 備考: 戻り値は操作が正しいかどうかの判断として使用されます。 { ngx_http_core_main_conf_t *cmcf = conf;

//create_main が設定されていませんif (cmcf->server_names_hash _max_size == _CONF_UNSET_UINT) { cmcf -> ;server_names_hash_max_size = 512; //これが

init }

if (cmcf ->server_names_hash_buck et_size == NGX_CONF_UNSET_UINT) {

cmcf- > server_names_hash_bucket_size = ngx_cacheline_size;

}

cmcf->server_names_hash_bucket_size =

ngx_align(cmcf->server_names_hash_bucket_size, ngx_cacheline_size);

if (cmcf->変数_hash_max_size == NGX_CONF_UNSET_UINT) {

cmcf->variables_hash_max_size = 512;

}

if (cmcf->variables_hash_bucket_size == NGX_CONF_UNSET_UINT) {

cmcf->variable s_hash_bucket_size = 64;

}

cmcf ->variables_hash_bucket_size =

ngx_align(cmcf->variables_hash_bucket_size, ngx_cacheline_size);

if (cm cf->ncaptures) {

cmcf->ncaptures = (cmcf- >ncaptures + 1) * 3;

}

return NGX_CONF_OK;

}

2.6 merge_srv_conf(ngx_conf_t *cf, void *prev, void *conf)

パラメータ：ngx_conf_t *cf、構成结构体、prevはmain の構成構造体、conf はserverの構成構造体；prev=cf->ctx.srv_conf[ctx_index],c/span>

戻り値： 文字* ，正确返還はNGX_CONF_OK；

备注：返還は操作が正しいかどうかの一つの判断です；

の例：

static char * ngx_http_barrier_merge_conf(ngx_conf_t *cf, void *parent, void *child)

{

ngx_http_barrier_conf_t *prev = 親;

ngx_http_barrier_conf_ t *conf = child;

if (conf->shm_zone == NULL){

*conf = *prev;

}

ngx_conf_merge_value(conf-& gt;有効化、prev->有効化、0);  //デフォルトは 0 です

return NGX_CONF_OK;

}

注:マージサーバーの主要な機能は、如果メイン里設定完了有効=1 ，而サーバー{}里有効= NGX_CONF_UNSET，则将serverのenable=mainのenable=1；

2.7 loc_conf(ngx_conf_t *cf, void *prev, void *conf)

原理同じmerge_srv_conf(ngx_conf_t *cf, void *prev, void *conf)

2.8 postconfiguration(ngx_conf_t *cf)

パラメータ：ngx_conf_t *cf；

返值： ngx_int_t、正确返值はNGX_OK；

备注：返還值は操作が正しいかどうかの一つの判断です。

例：

static ngx_int_t ngx_http_tracker_init(ngx_conf_t *cf)

{

ngx_tracker_flag = 0;

return NGX_OK;

}

注: グローバル変数を設定します flag barrierモジュールがあるかどうかを決定するためにクリアされます。クリアされていない場合は、設定に追加されていないと バリアが発生します。 ゾーン、kill –HUPのとき、グローバル変数flagの値は変化しないため、つまり、ユーザーがtraker コマンド、セグメンテーション違反が発生しました。 3、

HTTP コマンド4、一般的に使用される変数

#define NGX_HTTP_MAIN_CONF コマンドの保存場所

#define NGX_HTTP_SRV_CONF 0x04000000 #define NGX_HTTP_LOC_CONF 0x08000000

#define NGX_HTTP_UPS_CONF 0x10000000

#define NGX_HTTP_SIF_CONF 0x20000000

#define HTTP_LIF_CONF 0x40000000

#define NGX_HTTP_LMT_CONF 0x80000000

#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)

例:

static ngx_command_t ngx_http_print_commands [ ] = {{

ngx_string("print"),

NGX_HTTP_LOC_CONF|NGX_CONF_TAKE1,

ngx_http_ print_setup,

/ /set()

、読み取りに変換されます コマンドで渡されたパラメーターを入力し、適切な値を構成構造体に保存します

NGX_HTTP_LOC_CONF_OFFSET, offsetof(ngx_http_print_loc_conf_t, ed),

NULL

}、

ngx_null_command

};

5

、一般的に使用される関数

5.1 ProcessingRequest

ngx_http_get_module_main_conf Function関数:

requestに従って

リクエストとモジュールを取得メイン

の構成。 #define ngx_http_get_module_main_conf(r, module)

ngx_http_get_module_srv_conf

関数: requestリクエストに従って、server 設定。

#define ngx_http_get_module_srv_conf(r, module) (r)->srv_conf[module.ctx_index]

ngx_http_get_module_loc_conf

関数関数: による requestリクエストとモジュールは、locationを構成します。

#define ngx_http_get_module_loc_conf(r, module) (r)->loc_conf[module.ctx_index]

5.2 conf

ngx_http_conf_get_module_main_conf

Function 関数: conf 構造体とモジュールに基づいて main 設定を取得します。

#define ngx_http_conf_get_module_main_conf(cf, module) main_conf [module.ctx_index]

ngx_http_conf_get_module_srv_conf

関数:

は

confに従って設定されます 構造とモジュール。 #define ngx_http_conf_get_module_srv_conf(cf, module) gt;srv_conf[module.ctx_index] ngx_http_conf_get_module_loc_conf

関数:

は

confに従って設定されますの構造とモジュール。

#define ngx_http_conf_get_module_loc_conf(cf, module) t;loc_conf[module.ct x_index]5.3 サイクル ngx_http_cycle_get_module_main_conf

#define ngx_http_cycle_get_module_main_conf (サイクル、モジュール) (cycle->conf_ctx [ngx_http_module.index] ? [ngx_http_module.index]) NULL)

上記は、内容の側面も含めて nginx HTTP モジュールの構成を紹介したもので、PHP チュートリアルに興味のある友人に役立つことを願っています。