3.7.3　经典的“Hello World”示例

下面以经典的返回"Hello World"为例来编写一个最小的HTTP处理模块，以此介绍完整的ngx_http_mytest_handler处理方法。

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；

}

/设置返回的Content-Type。注意，ngx_str_t有一个很方便的初始化宏ngx_string，它可以把ngx_str_t的data和len成员都设置好/

ngx_str_t type=ngx_string（"text/plain"）；

//返回的包体内容

ngx_str_t response=ngx_string（"Hello World！"）；

//设置返回状态码

r-＞headers_out.status=NGX_HTTP_OK；

//响应包是有包体内容的，需要设置Content-Length长度

r-＞headers_out.content_length_n=response.len；

//设置Content-Type

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；

}

//将Hello World复制到ngx_buf_t指向的内存中

ngx_memcpy（b-＞pos,response.data,response.len）；

//注意，一定要设置好last指针

b-＞last=b-＞pos+response.len；

//声明这是最后一块缓冲区

b-＞last_buf=1；

//构造发送时的ngx_chain_t结构体

ngx_chain_t out；

//赋值ngx_buf_t

out.buf=b；

//设置next为NULL

out.next=NULL；

/最后一步为发送包体，发送结束后HTTP框架会调用ngx_http_finalize_request方法结束请求/

return ngx_http_output_filter（r，＆out）；

}