網(wǎng)上有很多關于pos機模塊無應答,寫一個Nginx的模塊沒有那么難的知識，也有很多人為大家解答關于pos機模塊無應答的問題，今天pos機之家(www.dsth100338.com)為大家整理了關于這方面的知識，讓我們一起來看下吧!
本文目錄一覽：
pos機模塊無應答
Nginx作為世界第二大Web服務器（第一是Apache），越來越受到大家的青睞。受到歡迎的一個重要原因，是他的高擴展性。它是由多個不同功能、不同層次、不同類型且耦合度極低的模塊組成。當我們開發(fā)自己的模塊時，不僅可以使用core模塊、events模塊、log模塊，而且我們開發(fā)的模塊是嵌入到二進制文件中執(zhí)行的，因此我們自己開發(fā)的模塊，也能具有優(yōu)秀的性能，享受Nginx的高并發(fā)特性。
本文以編寫一個http_hello_module為例，介紹編寫一個Nginx的http模塊的步驟，以及其中涉及的數(shù)據(jù)結構。以期打破大家對編寫nginx模塊的恐懼。
該示例模塊的功能是：每次訪問http時，http進行訪問計數(shù)，并把計數(shù)的值回顯給客戶端。
為了說明自定義的http模塊，是如何讀取配置文件的值，即在Nginx.conf文件中配置值，我們引入了兩個配置項hello_string、hello_counter。這兩個配置指令，僅可以出現(xiàn)在location指令的作用域中。hello_string用于展示字符串類型，它接收一個參數(shù)來設置回顯的字符串，或是零個參數(shù)，則使用默認的字符串作為回顯的字符串。而hello_counter，用于控制是否開啟訪問統(tǒng)計，如果設置為 on，則會在相應的字符串后面追加 Visited Times:的字樣，以統(tǒng)計請求的次數(shù)。我們的例子中，其中一個location的配置如下。
location /test { hello_string balabala; hello_counter on;}
我們自定義模塊的訪問效果如圖：
編寫http_hello_module一個簡單的http模塊，只需要定義一個結構體ngx_module_t的變量，他告訴Nginx框架，我們定義的模塊，
屬于什么模塊（如http模塊、filter模塊）需要哪些配置項，在哪個領域定義（如server域、http域、location域）。我們的例子中，需要兩個配置項：hello_string，hello_counter。在location作用域配置。配置項的類型，存儲結構。我們的例子中，一個是string類型，一個是int類型，定義結構如下：typedef struct{ ngx_str_t hello_string; ngx_int_t hello_counter;}ngx_http_hello_loc_conf_t;如何接收客戶端請求，對請求，又應該做出怎樣的應答。
下面，我們逐步了解ngx_module_t結構體是如何完成上述內(nèi)容的。ngx_module_t結構體的每個成員定義如下：
typedef struct ngx_module_s ngx_module_t;struct ngx_module_s { ngx_uint_t ctx_index; // 表示當前模塊在這類模塊中的序號。既用于表達優(yōu)先級，又用于 Nginx 框架快速獲得模塊的數(shù)據(jù) ngx_uint_t index; // 當前模塊在所有模塊的序號 char *name; ngx_uint_t spare0; // spare系列的保留變量，暫未使用 ngx_uint_t spare1; ngx_uint_t version; // 模塊的版本號，便于將來的擴展。 const char *signature; // 用于指向一類模塊的上下文結構體。ctx將會指向特定類型模塊的公共接口。例如在http模塊中，ctx指向ngx_http_module_t結構體 void *ctx; ngx_command_t *commands; // 將處理nginx.conf中的配置項 ngx_uint_t type; // 模塊類型。官方的取值包括：NGX_HTTP_MODULE, NGX_CORE_MODULE, NGX_CONF_MODULE, NGX_EVENT_MODULE, NGX_MAIL_MODULE /* * 以下七個函數(shù)指針，表示在七個階段，會調用這七個方法 */ ngx_int_t (*init_master)(ngx_log_t *log); // 在master進程啟動時?？蚣軙簳r沒用調用。所以，寫了也沒啥卵用 ngx_int_t (*init_module)(ngx_cycle_t *cycle); // 在初始化所有模塊時被調用。在master/worker模式下，在啟動worker進程前被調用 ngx_int_t (*init_process)(ngx_cycle_t *cycle); // 在每個worker進程的初始化過程會被調用 ngx_int_t (*init_thread)(ngx_cycle_t *cycle); // 不支持多線程，所以沒啥卵用 void (*exit_thread)(ngx_cycle_t *cycle); // 不支持 void (*exit_process)(ngx_cycle_t *cycle); // worker 進程會在退出前調用 void (*exit_master)(ngx_cycle_t *cycle); // 在master進程退出前被調用 //沒有用 uintptr_t spare_hook0; uintptr_t spare_hook1; uintptr_t spare_hook2; uintptr_t spare_hook3; uintptr_t spare_hook4; uintptr_t spare_hook5; uintptr_t spare_hook6; uintptr_t spare_hook7;};
對于ngx_module_t結構體的前7個成員，我們用Nginx提供的宏NGX_MODULE_V1進行初始化。
#define NGX_MODULE_V1 \\ NGX_MODULE_UNSET_INDEX, NGX_MODULE_UNSET_INDEX, \\ NULL, 0, 0, nginx_version, NGX_MODULE_SIGNATURE
對于ngx_module_t結構體的最后8個成員，我們用Nginx提供的宏NGX_MODULE_V1_PADDING進行初始化。
#define NGX_MODULE_V1_PADDING 0, 0, 0, 0, 0, 0, 0, 0
對于在七個階段會調用的函數(shù)指針，我們的http_hello_module并不需要，所以統(tǒng)一設置為NULL。
因為我們的例子是一個http模塊，因此type值，等于NGX_HTTP_MODULE。
通過以上分析可知，為了定義結構體ngx_module_s的對象，我們只需要定義以下兩個結構體的對象：
結構體ngx_http_module_t的對象，賦值給ctx，用于告知Nginx框架，我們的自定義模塊如何處理客戶端的請求結構體ngx_command_t的數(shù)組對象，賦值給commands，用于告知Nginx框架，我們的自定義模塊需要的配置項ngx_module_s的成員commands定義對于有配置項的模塊，需要定義一個結構體，用于存儲配置項的值。本例中，我們需要兩個配置項, hello_string和hello_counter，分別是string和int類型，因此，存儲配置項的結構體定義如下。
typedef struct{ ngx_str_t hello_string; ngx_int_t hello_counter;} ngx_http_hello_loc_conf_t;
有一點需要注意的是，在模塊的開發(fā)過程中，我們最好使用 Nginx 原有的命名習慣。這樣跟源代碼的契合度更高，看起來也更舒服。對于模塊配置信息的定義，命名習慣是ngx_http_<module name>_(main|srv|loc)_conf_t。
commands數(shù)組用于定義模塊的配置文件參數(shù)，每一個數(shù)組都是ngx_command_t類型，數(shù)組的結尾用ngx_null_command表示。Nginx框架在解析配置文件時，對于一個配置項，會遍歷所有的模塊。對每一個模塊，都會遍歷該模塊的commmands數(shù)組，直到遇到ngx_null_command。
ngx_command_t結構體定義了自己感興趣的一個配置項：
typedef struct ngx_command_s 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); ngx_uint_t conf; ngx_uint_t offset; void *post; };
結構體各成員的說明如下：
name: 配置指令的名稱。type: 配置項類型，該配置項可以出現(xiàn)的位置，如:server{}或location{}，以及它可以攜帶的參數(shù)個數(shù)。例如：NGX_HTTP_LOC_CONF|NGX_CONF_NOARGS|NGX_CONF_TAKE1 表示該配置項出現(xiàn)在location位置，接收0個或1個參數(shù)。set：是一個函數(shù)指針。出現(xiàn)了name中指定的配置項后，將會調用set方法處理配置項的參數(shù)conf: 該字段指定當前配置項存儲的內(nèi)存位置。因為 http 模塊對所有 http 模塊所要保存的配置信息，劃分了 main, server 和 location 三個地方進行存儲，每個地方都有一個內(nèi)存池用來分配存儲這些信息的內(nèi)存。這里可能的值為 NGX_HTTP_MAIN_CONF_OFFSET、NGX_HTTP_SRV_CONF_OFFSET 或 NGX_HTTP_LOC_CONF_OFFSET。offset: 指定該配置項值的精確存放位置，一般指定為某一個結構體變量的字段偏移。post: 配置項讀取后的處理方法因為我們的例子有兩個配置項，因此依次定義了兩個ngx_command_t，數(shù)組用ngx_null_command結尾。
static ngx_command_t ngx_http_hello_commands[] = { { ngx_string("hello_string"), // 配置項名字 NGX_HTTP_LOC_CONF|NGX_CONF_NOARGS|NGX_CONF_TAKE1, // 配置項出現(xiàn)的位置和接收的參數(shù)個數(shù) ngx_http_hello_string, // 在配置文件中讀到該配置項后，用該函數(shù)處理配置項 NGX_HTTP_LOC_CONF_OFFSET, // 配置項的值，用LOCATION的內(nèi)存池存儲 offsetof(ngx_http_hello_loc_conf_t, hello_string), // 存儲的精確位置 NULL }, { ngx_string("hello_counter"), NGX_HTTP_LOC_CONF|NGX_CONF_FLAG, ngx_http_hello_counter, NGX_HTTP_LOC_CONF_OFFSET, offsetof(ngx_http_hello_loc_conf_t, hello_counter), NULL }, ngx_null_command};
對于hello_string配置項，它的處理函數(shù)實現(xiàn)如下，ngx_conf_set_str_slot是Nginx提供的函數(shù)，讀取string類型的配置項。
static char *ngx_http_hello_string(ngx_conf_t *cf, ngx_command_t *cmd, void *conf){ ngx_http_hello_loc_conf_t* local_conf; local_conf = conf; char* rv = ngx_conf_set_str_slot(cf, cmd, conf); return rv;}
對于hello_counter配置項，他的處理函數(shù)實現(xiàn)如下，ngx_conf_set_flag_slot是Nginx提供的函數(shù)，讀取on/off值的配置項。
static char *ngx_http_hello_counter(ngx_conf_t *cf, ngx_command_t *cmd, void *conf){ ngx_http_hello_loc_conf_t* local_conf; local_conf = conf; char* rv = NULL; rv = ngx_conf_set_flag_slot(cf, cmd, conf); return rv;}ngx_module_s的成員ctx定義
ctx是結構體ngx_http_module_t的對象指針，主要用于定義在讀取配置文件的各個階段的處理函數(shù)。
下面展示的代碼，便是ngx_http_module_t這個結構體：
typedef struct { // 解析配置文件前調用 ngx_int_t (*preconfiguration)(ngx_conf_t *cf); // 完成配置文件的解析后調用 ngx_int_t (*postconfiguration)(ngx_conf_t *cf); // 創(chuàng)建數(shù)據(jù)結構，用于存儲main級別(直屬于http{...}塊的配置項)的全局配置項 void *(*create_main_conf)(ngx_conf_t *cf); // 初始化用于main級別的配置項 char *(*init_main_conf)(ngx_conf_t *cf, void *conf); //創(chuàng)建數(shù)據(jù)結構，用于存儲srv級別(直屬于虛擬主機server{...}塊的配置項)的配置項 void *(*create_srv_conf)(ngx_conf_t *cf); //合并main和srv級別下的同名配置項 char *(*merge_srv_conf)(ngx_conf_t *cf, void *prev, void *conf); // 創(chuàng)建數(shù)據(jù)結構，用于存儲loc級別(直屬于location{...}塊的配置項)的配置項 void *(*create_loc_conf)(ngx_conf_t *cf); // 合并srv和location級別下的同名配置項 char *(*merge_loc_conf)(ngx_conf_t *cf, void *prev, void *conf); } ngx_http_module_t;
在我們的例子中，ngx_http_module_t的各個字段的實現(xiàn)如下, 我們只關心location配置項的讀取以及在配置文件解析完成后的處理。location配置項讀取hello_string和hello_counter的值，配置文件解析完成后，我們掛載請求的處理函數(shù)。
static ngx_http_module_t ngx_http_hello_module_ctx = { NULL, /* preconfiguration */ ngx_http_hello_init, /* postconfiguration */ NULL, /* create main configuration */ NULL, /* init main configuration */ NULL, /* create server configuration */ NULL, /* merge server configuration */ ngx_http_hello_create_loc_conf, /* create location configuration */ NULL /* merge location configuration */};
我們先來看一下ngx_http_hello_create_loc_conf是如何存儲loc級別的配置項。 ngx_http_hello_create_loc_conf是告訴Ngixn模塊，我們使用的loc級別的配置項的信息，并對配置項進行初始化。
static void *ngx_http_hello_create_loc_conf(ngx_conf_t *cf){ ngx_http_hello_loc_conf_t* local_conf = NULL; local_conf = ngx_pcalloc(cf->pool, sizeof(ngx_http_hello_loc_conf_t)); if (local_conf == NULL) { return NULL; } ngx_str_null(&local_conf->hello_string); local_conf->hello_counter = NGX_CONF_UNSET; return local_conf;}
在配置文件處理完后，我們掛載模塊的處理函數(shù)。即告訴Nginx框架，當符合條件的請求過來時，我們自定義的模塊如何處理請求，如何響應請求。掛載是在配置文件解析完畢，由函數(shù)ngx_http_hello_init完成的。
static ngx_int_tngx_http_hello_init(ngx_conf_t *cf){ ngx_http_handler_pt *h; ngx_http_core_main_conf_t *cmcf; cmcf = ngx_http_conf_get_module_main_conf(cf, ngx_http_core_module); h = ngx_array_push(&cmcf->phases[NGX_HTTP_CONTENT_PHASE].handlers); if (h == NULL) { return NGX_ERROR; } *h = ngx_http_hello_handler; return NGX_OK;}
從上述代碼可知，我們掛載的處理函數(shù)為ngx_http_hello_handler，即由它處理客戶端請求、做出具體響應。
static ngx_int_tngx_http_hello_handler(ngx_http_request_t *r){ ngx_int_t rc; ngx_buf_t *b; ngx_chain_t out; ngx_http_hello_loc_conf_t* my_conf; u_char ngx_hello_string[1024] = {0}; ngx_uint_t content_length = 0; ngx_log_error(NGX_LOG_EMERG, r->connection->log, 0, "ngx_http_hello_handler is called!"); my_conf = ngx_http_get_module_loc_conf(r, ngx_http_hello_module); if (my_conf->hello_string.len == 0 ) { ngx_log_error(NGX_LOG_EMERG, r->connection->log, 0, "hello_string is empty!"); return NGX_DECLINED; } if (my_conf->hello_counter == NGX_CONF_UNSET || my_conf->hello_counter == 0) { ngx_sprintf(ngx_hello_string, "%s", my_conf->hello_string.data); } else { ngx_sprintf(ngx_hello_string, "%s Visited Times:%d", my_conf->hello_string.data, ++ngx_hello_visited_times); } ngx_log_error(NGX_LOG_EMERG, r->connection->log, 0, "hello_string:%s", ngx_hello_string); content_length = ngx_strlen(ngx_hello_string); /* we response to 'GET' and 'HEAD' requests only */ if (!(r->method & (NGX_HTTP_GET|NGX_HTTP_HEAD))) { return NGX_HTTP_NOT_ALLOWED; } /* discard request body, since we don't need it here */ rc = ngx_http_discard_request_body(r); if (rc != NGX_OK) { return rc; } ngx_str_set(&r->headers_out.content_type, "text/html"); /* send the header only, if the request type is http 'HEAD' */ if (r->method == NGX_HTTP_HEAD) { r->headers_out.status = NGX_HTTP_OK; r->headers_out.content_length_n = content_length; return ngx_http_send_header(r); } /* allocate a buffer for your response body */ b = ngx_pcalloc(r->pool, sizeof(ngx_buf_t)); if (b == NULL) { return NGX_HTTP_INTERNAL_SERVER_ERROR; } /* attach this buffer to the buffer chain */ out.buf = b; out.next = NULL; /* adjust the pointers of the buffer */ b->pos = ngx_hello_string; b->last = ngx_hello_string + content_length; b->memory = 1; /* this buffer is in memory */ b->last_buf = 1; /* this is the last buffer in the buffer chain */ /* set the status line */ r->headers_out.status = NGX_HTTP_OK; r->headers_out.content_length_n = content_length; /* send the headers of your response */ rc = ngx_http_send_header(r); if (rc == NGX_ERROR || rc > NGX_OK || r->header_only) { return rc; } /* send the buffer chain of your response */ return ngx_http_output_filter(r, &out);}如何把http_hello_module編譯進Nginx
上面介紹了，編寫一個http模塊的基本要素。接下來，介紹如何把這個簡單的模塊編譯進Nginx框架，從而讓它發(fā)揮作用。
方案一：在執(zhí)行configure命令時，添加--add-module參數(shù)Nginx提供了一種簡單的方式將第三方的模塊編譯進Nginx中。首先是把第三方的源代碼全部放在一個目錄中， 并在該目錄下新建一個名為config的文件，這個config文件的目的，就是告訴Nginx如何編譯我們自己的模塊。在執(zhí)行Nginx的configure命令時， 加入?yún)?shù) --add-module=PATH，PATH就是我們存放config的目錄，就可以把我們開發(fā)的http_hello_module編譯進Nginx。
我們的http_hello_module是一個http模塊，因此config文件中只需要定義以下三個變量：
ngx_addon_name: 僅在configure執(zhí)行時使用，一般設置為模塊名稱。HTTP_MODULES: 添加自定義模塊的名稱。NGX_ADDON_SRCS：指定新增模塊的源代碼。如果有多個文件，則以空格隔開。我們的http_hello_module例子，它的config文件完整內(nèi)容如下。$ngx_addon_dir變量的值，等于我們在執(zhí)行configure命令時，參數(shù)--add-module的值。
ngx_addon_name=ngx_http_hello_moduleHTTP_MODULES="$HTTP_MODULES ngx_http_hello_module"NGX_ADDON_SRCS="$NGX_ADDON_SRCS $ngx_addon_dir/ngx_http_hello_module.c"
因為我們本例是編寫一個http module，因此賦值了HTTP_MODULES。如果是編寫其他模塊，如http 過濾模塊、Nginx核心模塊、事件模塊、http頭部過濾模塊，則應該分別對變量HTTP_FILTER_MODULES、CORE_MODULES、EVENT_MODULES、HTTP_HEADER_FILTER_MODULES。
方案二：在執(zhí)行configure命令后，修改Makefile文件Nginx提供的另一種方法是直接修改Makefile文件。在執(zhí)行完configure腳本后，會在objs/Makefile和objs/ngx_modules.c文件。我們可以直接修改這兩個文件，從而完成http_hello_module編譯進Nginx的目標。
以上就是關于pos機模塊無應答,寫一個Nginx的模塊沒有那么難的知識，后面我們會繼續(xù)為大家整理關于pos機模塊無應答的知識，希望能夠幫助到大家！
