最簡單的Nginx模塊開發，雖然簡單，但是是最重要的第一步。

主要是看：http://blog.codinglabs.org/articles/intro-of-nginx-module-development.html

?

1.準備模塊文件

在nginx-1.4.2安裝目錄新建一個自己的模塊的目錄

# mkdir myModule

再新建ngx_http_echo目錄

#mkdir ngx_http_echo

新建2個文件，一個就是模塊的 C 源碼文件，還有個模塊的配置文件config文件。

config比較簡單：

ngx_addon_name=ngx_http_echo_module
HTTP_MODULES="$HTTP_MODULES ngx_http_echo_module"
NGX_ADDON_SRCS="$NGX_ADDON_SRCS $ngx_addon_dir/ngx_http_echo_module.c"

ngx_http_echo_module.c文件

#include <ngx_config.h>
#include <ngx_core.h>
#include <ngx_http.h>
/* Module config */
typedef struct {ngx_str_t  ed;
} ngx_http_echo_loc_conf_t;
static char *ngx_http_echo(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
static void *ngx_http_echo_create_loc_conf(ngx_conf_t *cf);
static char *ngx_http_echo_merge_loc_conf(ngx_conf_t *cf, void *parent, void *child);
/* Directives */
static ngx_command_t  ngx_http_echo_commands[] = {{ ngx_string("echo"),NGX_HTTP_LOC_CONF|NGX_CONF_TAKE1,ngx_http_echo,NGX_HTTP_LOC_CONF_OFFSET,offsetof(ngx_http_echo_loc_conf_t, ed),NULL },ngx_null_command
};
/* Http context of the module */
static ngx_http_module_t  ngx_http_echo_module_ctx = {NULL,                                  /* preconfiguration */NULL,                                  /* postconfiguration */NULL,                                  /* create main configuration */NULL,                                  /* init main configuration */NULL,                                  /* create server configuration */NULL,                                  /* merge server configuration */ngx_http_echo_create_loc_conf,         /* create location configration */ngx_http_echo_merge_loc_conf           /* merge location configration */
};
/* Module */
ngx_module_t  ngx_http_echo_module = {NGX_MODULE_V1,&ngx_http_echo_module_ctx,             /* module context */ngx_http_echo_commands,                /* module directives */NGX_HTTP_MODULE,                       /* module type */NULL,                                  /* init master */NULL,                                  /* init module */NULL,                                  /* init process */NULL,                                  /* init thread */NULL,                                  /* exit thread */NULL,                                  /* exit process */NULL,                                  /* exit master */NGX_MODULE_V1_PADDING
};
/* Handler function */
static ngx_int_t
ngx_http_echo_handler(ngx_http_request_t *r)
{ngx_int_t rc;ngx_buf_t *b;ngx_chain_t out;ngx_http_echo_loc_conf_t *elcf;elcf = ngx_http_get_module_loc_conf(r, ngx_http_echo_module);if(!(r->method & (NGX_HTTP_HEAD|NGX_HTTP_GET|NGX_HTTP_POST))){return NGX_HTTP_NOT_ALLOWED;}r->headers_out.content_type.len = sizeof("text/html") - 1;r->headers_out.content_type.data = (u_char *) "text/html";r->headers_out.status = NGX_HTTP_OK;r->headers_out.content_length_n = elcf->ed.len;if(r->method == NGX_HTTP_HEAD){rc = ngx_http_send_header(r);if(rc != NGX_OK){return rc;}}b = ngx_pcalloc(r->pool, sizeof(ngx_buf_t));if(b == NULL){ngx_log_error(NGX_LOG_ERR, r->connection->log, 0, "Failed to allocate response buffer.");return NGX_HTTP_INTERNAL_SERVER_ERROR;}out.buf = b;out.next = NULL;b->pos = elcf->ed.data;b->last = elcf->ed.data + (elcf->ed.len);b->memory = 1;b->last_buf = 1;rc = ngx_http_send_header(r);if(rc != NGX_OK){return rc;}return ngx_http_output_filter(r, &out);
}
static char *
ngx_http_echo(ngx_conf_t *cf, ngx_command_t *cmd, void *conf)
{ngx_http_core_loc_conf_t  *clcf;clcf = ngx_http_conf_get_module_loc_conf(cf, ngx_http_core_module);clcf->handler = ngx_http_echo_handler;ngx_conf_set_str_slot(cf,cmd,conf);return NGX_CONF_OK;
}
static void *
ngx_http_echo_create_loc_conf(ngx_conf_t *cf)
{ngx_http_echo_loc_conf_t  *conf;conf = ngx_pcalloc(cf->pool, sizeof(ngx_http_echo_loc_conf_t));if (conf == NULL) {return NGX_CONF_ERROR;}conf->ed.len = 0;conf->ed.data = NULL;return conf;
}
static char *
ngx_http_echo_merge_loc_conf(ngx_conf_t *cf, void *parent, void *child)
{ngx_http_echo_loc_conf_t *prev = parent;ngx_http_echo_loc_conf_t *conf = child;ngx_conf_merge_str_value(conf->ed, prev->ed, "");return NGX_CONF_OK;
}

?

2.配置編譯和安裝

由于gdb需要gcc的時候加上-g參數，這樣生成的文件才能使用gdb調試，因此我們要對源碼做一下小改動

修改auto/cc/conf文件

ngx_compile_opt="-c"

變為

ngx_compile_opt="-c -g"

?

# ./configure --prefix=/usr/local/nginx --add-module=/usr/nginx-1.4.2/myModule/ngx_http_echo

# make?CFLAGS="-g?-O0"

# make install

修改nginx.conf文件

在

??????? location / {
??????????? root?? /usr/www;
??????????? index? index.html index.htm;
??????? }

下增加

location /echo {
??? echo "我的第一個nginx模塊!!!";
}

?

啟動nginx

# /usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx.conf

?

瀏覽
http://192.168.20.59/echo

另外還可以參考：

64位Linux編譯安裝調試Nginx+PHP(phpfpm)

解剖Nginx·模塊開發篇（1）跑起你的 Hello World 模塊！

總結

以上是生活随笔為你收集整理的Nginx模块开发的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。