Nigix加入Hello World模块

详细资料：<深入理解Nginx>

1.编写第三方模块

建立文件夹hello，里面有两个文件：

ngx_http_mytest_module.c

 #include <ngx_config.h>
 #include <ngx_core.h>
 #include <ngx_http.h>

 static char *
 ngx_http_mytest(ngx_conf_t *cf,ngx_command_t *cmd,void *conf);
 static ngx_int_t
 ngx_http_mytest_handler(ngx_http_request_t *r);

 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,
         //出现了name中指定的配置项后，将会调用该方法处理配置项的参数
         ngx_http_mytest,
         NGX_HTTP_LOC_CONF_OFFSET,
         ,
         NULL
     },
     ngx_null_command
 };

 static char *
 ngx_http_mytest(ngx_conf_t *cf,ngx_command_t *cmd,void *conf)
 {
     //找到mytest配置项所属的配置块
     ngx_http_core_loc_conf_t *clcf;
     clcf=ngx_http_conf_get_module_loc_conf(cf,ngx_http_core_module);
     /*
         HTTP框架在处理用户请求进行到NGX_HTTP_CONTENT_PHASE阶段时
         如果请求的主机域名、URI与mytest配置项所在的配置块相匹配，
         就将调用我们事先的ngx_http_mytest_handler方法处理这个请求
     */
     clcf->handler=ngx_http_mytest_handler;
     return NGX_CONF_OK;
 }

 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_module_t结构体
     &ngx_http_mytest_module_ctx,
     //用来处理nginx.conf中的配置项
     ngx_http_mytest_commands,
     //表示该模块的类型
     NGX_HTTP_MODULE,
     NULL,
     NULL,
     NULL,
     NULL,
     NULL,
     NULL,
     NULL,
     NGX_MODULE_V1_PADDING
 };

 static ngx_int_t ngx_http_mytest_handler(ngx_http_request_t *r)
 {
     //判断请求方法是否为GET或者HEAD，否则返回405 Not Allowed
     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("Hello World!");
     r->headers_out.status=NGX_HTTP_OK;
     r->headers_out.content_length_n=response.len;
     r->headers_out.content_type=type;

     //发送HTTP头部
     rc=ngx_http_send_header(r);
     if(rc==NGX_ERROR||rc>NGX_OK||r->header_only){
         return rc;
     }

     //构造ngx_buf_t结构体准备发送包体
     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结构体
     ngx_chain_t out;
     out.buf=b;
     out.next=NULL;
     return ngx_http_output_filter(r,&out);
 }

config

 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"

2.编译第三方模块(nginx源码目录下)

在未安装nginx的情况下安装第三方模块

# ./configure --prefix=/usr/local/nginx \
  --add-module=/第三方模块目录

在已安装nginx情况下安装第三方模块

# ./configure --prefix=/usr/local/nginx \
  --add-module=/第三方模块目录
# make
# /usr/local/nginx/sbin/nginx -s stop
# cp objs/nginx /usr/local/nginx/sbin/nginx
# /usr/local/nginx/sbin/nginx

3.使用第三方模块

使用一个模块需要根据这个模块定义的配置指令来做。比如我们这个简单的hello handler module的时候就很简单。

在nginx.conf文件中在http里面的默认的server里面加入如下配置

location /test {
    mytest;
}

4.使用telnet查看结果