正文

nginx（一）

IP云
IP云V管理员/2 阅读
09/03
提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

crul新浪微博的时候发现对面用的是nginx服务器，在虎扑足球（挺好的足球论坛）讨论世界杯也发现他们也用这nginx，联想到阿里的tengine也是基于nginx的，觉得有了解一下nginx的必要了。

1.nginx安装

nginx安装跟普通开源软件安装相似（都使用makefile），具体流程:下载源文件，./configure，make，make install。

在./configure过程中，会出现一些找不到一些依赖组件的提示，自行安装即可。可以通过源码编译方式安装对应组件。也可以通过系统自带的安装方式进行，比如在使用fedora安装相关openssl组件时，

sudo yum install openssl-devel这里会添加相应的编程关联文件，如果仅仅是sudo yum install openssl就可能出现错误。

./configure过程中存在一些比较实用的参数，如

./configure --prefix=/../.. --with-http_ssl_module --with-openssl=/../.. --add-module=/home/..

这些参数不加的话也会设置相应的默认值。

2.程序

nginx_http_mytest_module.c

#include <ngx_config.h>
#include <ngx_core.h>
#include <ngx_http.h>static ngx_int_t ngx_http_mytest_handler(ngx_http_request_t *r);
static char *
ngx_http_mytest(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);static ngx_command_t ngx_http_mytest_commands[] = {
{
ngx_string("mytest"),
NGX_HTTP_MAIN_CONF|NGX_HTTP_SRV_CONF|NGX_HTTP_LOC_CONF|NGX_HTTP_LMT_CONF|NGX_CONF_NOARGS,
ngx_http_mytest,
NGX_HTTP_LOC_CONF_OFFSET,
,
NULL
},
ngx_null_command
};static ngx_http_module_t ngx_http_mytest_module_ctx = {
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL
};ngx_module_t ngx_http_mytest_module = {
NGX_MODULE_V1,
&ngx_http_mytest_module_ctx,
ngx_http_mytest_commands,
NGX_HTTP_MODULE,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NGX_MODULE_V1_PADDING
};static char *
ngx_http_mytest(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_mytest_handler; return NGX_CONF_OK;
}static ngx_int_t ngx_http_mytest_handler(ngx_http_request_t *r)
{
if (!(r->method & (NGX_HTTP_GET | NGX_HTTP_HEAD))) {
return NGX_HTTP_NOT_ALLOWED;
} ngx_int_t rc = ngx_http_discard_request_body(r);
if (rc != NGX_OK) {
return rc;
} ngx_str_t type = ngx_string("text/plain");
ngx_str_t response = ngx_string("miao miao");
r->headers_out.status = NGX_HTTP_OK;
r->headers_out.content_length_n = response.len;
r->headers_out.content_type = type; rc = ngx_http_send_header(r);
if (rc == NGX_ERROR || rc > NGX_OK || r->header_only) {
return rc;
} ngx_buf_t *b;
b = ngx_create_temp_buf(r->pool, response.len);
if (b == NULL) {
return NGX_HTTP_INTERNAL_SERVER_ERROR;
} ngx_memcpy(b->pos, response.data, response.len);
b->last = b->pos + response.len;
b->last_buf = ; ngx_chain_t out;
out.buf = b;
out.next = NULL; return ngx_http_output_filter(r, &out);
}

a.ngx_command_t

定义服务器配置文件（安装目录/conf/nginx.conf）对应的配置项，并定义了配置项对应的回调函数，在此为ngx_http_mytest。

b.ngx_http_module_t

模块上下文,每个null分别对应着一个函数指针

ngx_http_module_t ngx_http_mytest_module_ctx = { NULL, /* preconfiguration */
NULL, /* postconfiguration */ NULL, /* create main configuration */
NULL, /* init main configuration */ NULL, /* create server configuration */
NULL, /* merge server configuration */ NULL, /* create location configuration */
NULL /* merge location configuration */
};

c.ngx_module_t

对于开发一个模块来说，需要定义一个ngx_module_t类型的变量来说明这个模块本身的信息，从某种意义上来说，这是这个模块最重要的一个信息，它告诉了nginx这个模块的一些信息，上面定义的配置信息，还有模块上下文信息，都是通过这个结构来告诉nginx系统的，也就是加载模块的上层代码，都需要通过定义的这个结构，来获取这些信息。

ngx_module_t ngx_http_mytest_module = {
NGX_MODULE_V1,/*#define NGX_MODULE_V1 0, 0, 0, 0,NGX_DSO_ABI_COMPATIBILITY, NGX_NUMBER_MAJOR, NGX_NUMBER_MINOR*/
&ngx_http_mytest_module_ctx,/* module context */
ngx_http_mytest_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 /*#define NGX_MODULE_V1_PADDING 0, 0, 0, 0, 0, 0, 0, 0*/
};

3.编译安装新模块

Nginx提供了一种简单的方式将第三方的模块编译到Nginx中。首先把源代码文件全部放到一个目录下，同时在该目录中编写一个文件用于通知Nginx如何编译本模块，这个文件名必须为config。然后，在configure脚本执行时加入参数--add-module=PATH(新模块源代码以及config文件存放目录)，就可以在执行政策编译安装流程时完成Nginx编译工作。Nginx添加新模块要求整个服务器重新编译应该是为了性能的需求。

config文件格式
config文件其实是一个可执行的Shell脚本，如果只想开发一个HTTP模块，需要定义三个变量：
（1）ngx_adon_name。
仅在configure执行时使用，一般设置为模块名称。
（2）HTTP_MODULES。
保存所有的HTTP模块名称。每个模块间由空格相连。在重新设置这个变量时，不要直接覆盖，因此要如下设置：
"$HTTP_MODULES ngx_http_mytest_module"
（3）NGX_ADDON_SRCS。
用于指定新模块的源代码，多个待编译的源代码之间可以用空格相连。
注意，在设置这个变量时可以使用$ngx_addon_dir变量，它等价于configure执行时--add-module=PATH的PATH参数。

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

编译安装新模块的命令如下：

./configure --prefix=/usr/local/nginx（指定安装部署后的根目录） --add-module=/home/nginx（新模块存放目录）
make
sudo make install

4.推荐内容

Nginx开发从入门到精通http://tengine.taobao.org/book/index.html