Nginx:解析HTTP配置的流程

  1 #include <ngx_config.h>
  2 #include <ngx_core.h>
  3 #include <ngx_http.h>
  4 
  5 typedef struct{
  6     ngx_str_t my_str;
  7 }ngx_http_mytest_conf_t;
  8 
  9 static ngx_int_t 
 10 ngx_http_mytest_handler(ngx_http_request_t *r);
 11 
 12 //创建mytest模块对应的结构体ngx_http_mytest_conf;
 13 static void *ngx_http_mytest_create_loc_conf(ngx_conf_t *cf)
 14 {
 15     ngx_http_mytest_conf_t *mycf;
 16     mycf=(ngx_http_mytest_conf_t *)ngx_pcalloc(cf->pool,sizeof(ngx_http_mytest_conf_t));
 17     if(mycf==NULL){
 18         return NULL;
 19     }
 20     return mycf;
 21 }
 22 
 23 static ngx_command_t ngx_http_mytest_commands[] = {
 24     {
 25         ngx_string("response_line"),   //配置项名称
 26         NGX_HTTP_LOC_CONF|NGX_CONF_TAKE1,    //配置项只能出现在location块中并且配置参数数量为1个
 27         ngx_conf_set_str_slot,  //使用预设的解析方法解析配置参数，表示我们希望用ngx_str_t类型的变量来保存这个配置项的参数
 28         NGX_HTTP_LOC_CONF_OFFSET,  //使用create_loc_conf方法产生的结构体来存储解析出的配置项参数
 29         offsetof(ngx_http_mytest_conf_t,my_str), //与上面两个成员一起使用，通过这3个成员来找到该配置参数存放的位置(ngx_http_mytest_conf_t.my_str)。
 30         NULL
 31     },
 32     ngx_null_command
 33 };
 34 
 35 //挂载handler
 36 static ngx_int_t
 37 ngx_http_mytest_init(ngx_conf_t *cf)
 38 {
 39         ngx_http_handler_pt        *h;
 40         ngx_http_core_main_conf_t  *cmcf;
 41 
 42         cmcf = ngx_http_conf_get_module_main_conf(cf, ngx_http_core_module);
 43 
 44         h = ngx_array_push(&cmcf->phases[NGX_HTTP_CONTENT_PHASE].handlers);
 45         if (h == NULL) {
 46                 return NGX_ERROR;
 47         }
 48 
 49         *h = ngx_http_mytest_handler;
 50 
 51         return NGX_OK;
 52 }
 53 
 54 static ngx_http_module_t ngx_http_mytest_module_ctx={
 55     NULL,
 56     ngx_http_mytest_init,
 57     NULL,
 58     NULL,
 59     NULL,
 60     NULL,
 61     ngx_http_mytest_create_loc_conf,
 62     NULL
 63 };
 64 
 65 ngx_module_t ngx_http_mytest_module={
 66     NGX_MODULE_V1,
 67     //指向ngx_http_module_t结构体
 68     &ngx_http_mytest_module_ctx,
 69     //用来处理nginx.conf中的配置项
 70     ngx_http_mytest_commands,
 71     //表示该模块的类型
 72     NGX_HTTP_MODULE,
 73     NULL,
 74     NULL,
 75     NULL,
 76     NULL,
 77     NULL,
 78     NULL,
 79     NULL,
 80     NGX_MODULE_V1_PADDING
 81 };
 82 
 83 static ngx_int_t ngx_http_mytest_handler(ngx_http_request_t *r)
 84 {
 85     //判断请求方法是否为GET或者HEAD，否则返回405 Not Allowed
 86     if(!(r->method & (NGX_HTTP_GET|NGX_HTTP_HEAD))){
 87         return NGX_HTTP_NOT_ALLOWED;
 88     }
 89     
 90     //丢弃请求中的包体
 91     ngx_int_t rc=ngx_http_discard_request_body(r);
 92     if(rc!=NGX_OK){
 93         return rc;
 94     }
 95     
 96     //设置相应头
 97     ngx_str_t type=ngx_string("text/plain");
 98     //获取配置参数
 99     ngx_http_mytest_conf_t* my_conf;
100     my_conf = ngx_http_get_module_loc_conf(r, ngx_http_mytest_module);
101     ngx_str_t response=my_conf->my_str;
102     r->headers_out.status=NGX_HTTP_OK;
103     r->headers_out.content_length_n=response.len;
104     r->headers_out.content_type=type;
105     
106     //发送HTTP头部
107     rc=ngx_http_send_header(r);
108     if(rc==NGX_ERROR||rc>NGX_OK||r->header_only){
109         return rc;
110     }
111     
112     //构造ngx_buf_t结构体准备发送包体
113     ngx_buf_t *b;
114     b=ngx_create_temp_buf(r->pool,response.len);
115     if(b==NULL){
116         return NGX_HTTP_INTERNAL_SERVER_ERROR;
117     }
118     ngx_memcpy(b->pos,response.data,response.len);
119     b->last=b->pos+response.len;
120     b->last_buf=1;
121     
122     //构造发送时的ngx_chain_t结构体
123     ngx_chain_t out;
124     out.buf=b;
125     out.next=NULL;
126     return ngx_http_output_filter(r,&out);
127 }