1. 初探nginx架构
2. handler模块
3. Nginx编译、安装、配置
4. Hello World模块开发

1. master进程主要用来管理worker进程，包含：1) 接收来自外界的信号2) 向各worker进程发送信号3) 监控worker进程的运行状态4) 当worker进程退出后(异常情况下)，会自动重新启动新的worker进程
2. woker进程: 基本的网络事件，则是放在worker进程中来处理了1) 多个worker进程之间是对等的，他们同等竞争来自客户端的请求，各进程互相之间是独立的2) 一个请求，只可能在一个worker进程中处理，一个worker进程，不可能处理其它进程的请求3) worker进程的个数是可以设置的，一般我们会设置与机器cpu核数一致，这里面的原因与nginx的进程模型以及事件处理模型是分不开的 

1. 首先master进程在接到信号后，会先重新加载配置文件
2. 然后再启动新的worker进程，并向所有老的worker进程发送信号，告诉他们可以光荣退休了
3. 新的worker在启动后，就开始接收新的请求(并获取新的配置文件)
4. 而老的worker在收到来自master的信号后，就不再接收新的请求，并且在当前进程中的所有未处理完的请求处理完成后，再退出
/*
当然，直接给master进程发送信号，这是比较老的操作方式，nginx在0.8版本之后，引入了一系列命令行参数，来方便我们管理。比如1) ./nginx -s reload: 重启nginx: 执行命令时，我们是启动一个新的nginx进程，而新的nginx进程在解析到reload参数后，就知道我们的目的是控制nginx来重新加载配置文件了，它会向master进程发送信号，然后接下来的动作，就和我们直接向master进程发送信号一样了2) ./nginx -s stop: 停止nginx的运行
*/

1. 每个worker进程都是从master进程fork过来
2. 在master进程里面，先建立好需要listen的socket(listenfd)之后，然后再fork出多个worker进程
3. 所有worker进程的listenfd会在新连接到来时变得可读(子进程和父进程通过fork共享文件句柄，这使得所有worker进程能够拥有同等的机会处理本次请求)，为保证只有一个进程处理该连接，所有worker进程在注册listenfd读事件前抢accept_mutex，抢到互斥锁的那个进程注册listenfd读事件，在读事件里调用accept接受该连接(connfd)
//所有worker进程都会去争夺listenfd的读权限，但只有一个worker能最终获得，并调用accept获得connfd，进行后续的动作，而其他未争夺到本次listenfd的worker则继续等待下一次连接并争夺listenfd
4. 当一个worker进程在accept这个连接之后，就开始读取请求，解析请求，处理请求，产生数据后，再返回给客户端，最后才断开连接，这样一个完整的请求就是这样的了
5. 我们可以看到，一个请求，完全由worker进程来处理，而且只在一个worker进程中处理 

1. 对于每个worker进程来说，独立的进程，不需要加锁，所以省掉了锁带来的开销
2. 同时在编程以及问题查找时，也会方便很多
3. 采用独立的进程，可以让互相之间不会影响，一个进程退出后，其它进程还在工作，服务不会中断，master进程则很快启动新的worker进程

http://tengine.taobao.org/book/chapter_02.html#

1. handler: Handler模块就是接受来自客户端的请求并产生输出的模块
配置文件中使用location指令可以配置content handler模块，当Nginx系统启动的时候，每个handler模块都有一次机会把自己关联到对应的location上(如果有多个handler模块都关联了同一个location，那么实际上只有一个handler模块真正会起作用)
handler模块处理的结果通常有三种情况1) 处理成功2) 处理失败(处理的时候发生了错误)3) 拒绝去处理。在拒绝处理的情况下，这个location的处理就会由默认的handler模块来进行处理。例如，当请求一个静态文件的时候，如果关联到这个location上的一个handler模块拒绝处理，就会由默认的ngx_http_static_module模块进行处理，该模块是一个典型的handler模块 2. filter
3. load-balancer

1. main
2. server
3. location

ngx_http_<module name>_(main|srv|loc)_conf_t。这里有个例子

struct ngx_command_s
{//配置指令的名称
    ngx_str_t             name;/*该配置的类型，其实更准确一点说，是该配置指令属性的集合。nginx提供了很多预定义的属性值(一些宏定义)，通过逻辑或运算符可组合在一起，形成对这个配置指令的详细的说明1. NGX_CONF_NOARGS：配置指令不接受任何参数2. NGX_CONF_TAKE1：配置指令接受1个参数3. NGX_CONF_TAKE2：配置指令接受2个参数4. NGX_CONF_TAKE3：配置指令接受3个参数5. NGX_CONF_TAKE4：配置指令接受4个参数6. NGX_CONF_TAKE5：配置指令接受5个参数7. NGX_CONF_TAKE6：配置指令接受6个参数8. NGX_CONF_TAKE7：配置指令接受7个参数可以组合多个属性，比如一个指令即可以不填参数，也可以接受1个或者2个参数。那么就是NGX_CONF_NOARGS|NGX_CONF_TAKE1|NGX_CONF_TAKE21. NGX_CONF_TAKE12：配置指令接受1个或者2个参数2. NGX_CONF_TAKE13：配置指令接受1个或者3个参数3. NGX_CONF_TAKE23：配置指令接受2个或者3个参数4. NGX_CONF_TAKE123：配置指令接受1个或者2个或者3参数5. NGX_CONF_TAKE1234：配置指令接受1个或者2个或者3个或者4个参数6. NGX_CONF_1MORE：配置指令接受至少一个参数7. NGX_CONF_2MORE：配置指令接受至少两个参数8. NGX_CONF_MULTI: 配置指令可以接受多个参数，即个数不定1. NGX_CONF_BLOCK：配置指令可以接受的值是一个配置信息块。也就是一对大括号括起来的内容。里面可以再包括很多的配置指令。比如常见的server指令就是这个属性的2. NGX_CONF_FLAG：配置指令可以接受的值是”on”或者”off”，最终会被转成bool值3. NGX_CONF_ANY：配置指令可以接受的任意的参数值。一个或者多个，或者”on”或者”off”，或者是配置块值得注意的是，无论如何，nginx的配置指令的参数个数不可以超过NGX_CONF_MAX_ARGS个。目前这个值被定义为8，也就是不能超过8个参数值下面介绍一组说明配置指令可以出现的位置的属性。1. NGX_DIRECT_CONF：可以出现在配置文件中最外层。例如已经提供的配置指令daemon，master_process等2. NGX_MAIN_CONF: http、mail、events、error_log等3. NGX_ANY_CONF: 该配置指令可以出现在任意配置级别上对于我们编写的大多数模块而言，都是在处理http相关的事情，也就是所谓的都是NGX_HTTP_MODULE，对于这样类型的模块，其配置可能出现的位置也是分为直接出现在http里面，以及其他位置1. NGX_HTTP_MAIN_CONF: 可以直接出现在http配置指令里2. NGX_HTTP_SRV_CONF: 可以出现在http里面的server配置指令里3. NGX_HTTP_LOC_CONF: 可以出现在http server块里面的location配置指令里4. NGX_HTTP_UPS_CONF: 可以出现在http里面的upstream配置指令里5. NGX_HTTP_SIF_CONF: 可以出现在http里面的server配置指令里的if语句所在的block中6. NGX_HTTP_LMT_CONF: 可以出现在http里面的limit_except指令的block中7. NGX_HTTP_LIF_CONF: 可以出现在http server块里面的location配置指令里的if语句所在的block中。*/ngx_uint_t            type;/*set是一个函数指针，当nginx在解析配置的时候，如果遇到这个配置指令，将会把读取到的值传递给这个函数进行分解处理。因为具体每个配置指令的值如何处理，只有定义这个配置指令的人是最清楚的 char *(*set)(ngx_conf_t *cf, ngx_command_t *cmd, void *conf); 1. cf: 该参数里面保存从配置文件读取到的原始字符串以及相关的一些信息。特别注意的是这个参数的args字段是一个ngx_str_t类型的数组1) 该数组的首个元素是这个配置指令本身2) 第二个元素是指令的第一个参数3) 第三个元素是第二个参数，依次类推2. cmd: 这个配置指令对应的ngx_command_t结构3. conf: 就是定义的存储这个配置值的结构体。用户在处理的时候可以使用类型转换，转换成自己知道的类型，再进行字段的赋值为了更加方便的实现对配置指令参数的读取，nginx已经默认提供了对一些标准类型的参数进行读取的函数，可以直接赋值给set字段使用。下面来看一下这些已经实现的set类型函数1. ngx_conf_set_flag_slot： 读取NGX_CONF_FLAG类型的参数2. ngx_conf_set_str_slot:读取字符串类型的参数3. ngx_conf_set_str_array_slot: 读取字符串数组类型的参数4. ngx_conf_set_keyval_slot： 读取键值对类型的参数5. ngx_conf_set_num_slot: 读取整数类型(有符号整数ngx_int_t)的参数6. ngx_conf_set_size_slot:读取size_t类型的参数，也就是无符号数7. ngx_conf_set_off_slot: 读取off_t类型的参数8. ngx_conf_set_msec_slot: 读取毫秒值类型的参数9. ngx_conf_set_sec_slot: 读取秒值类型的参数10. ngx_conf_set_bufs_slot： 读取的参数值是2个，一个是buf的个数，一个是buf的大小。例如： output_buffers 1 128k;11. ngx_conf_set_enum_slot: 读取枚举类型的参数，将其转换成整数ngx_uint_t类型12. ngx_conf_set_bitmask_slot: 读取参数的值，并将这些参数的值以bit位的形式存储。例如：HttpDavModule模块的dav_methods指令   */char               *(*set)(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);/*该字段被NGX_HTTP_MODULE类型模块所用(我们编写的基本上都是NGX_HTTP_MOUDLE，只有一些nginx核心模块是非NGX_HTTP_MODULE)，该字段指定当前配置项存储的内存位置。实际上是使用哪个内存池的问题因为http模块对所有http模块所要保存的配置信息，划分了main, server和location三个地方进行存储，每个地方都有一个内存池用来分配存储这些信息的内存。这里可能的值为 1. NGX_HTTP_MAIN_CONF_OFFSET2. NGX_HTTP_SRV_CONF_OFFSET3. NGX_HTTP_LOC_CONF_OFFSET4. 0(NGX_HTTP_MAIN_CONF_OFFSET)*/ngx_uint_t            conf;/*指定该配置项值的精确存放位置，一般指定为某一个结构体变量的字段偏移。因为对于配置信息的存储，一般我们都是定义个结构体来存储的那么比如我们定义了一个结构体A，该项配置的值需要存储到该结构体的b字段。那么在这里就可以填写为offsetof(A, b)对于有些配置项，它的值不需要保存或者是需要保存到更为复杂的结构中时，这里可以设置为0 */ngx_uint_t            offset;//该字段存储一个指针。可以指向任何一个在读取配置过程中需要的数据，以便于进行配置读取的处理。大多数时候，都不需要，所以简单地设为0即可void                 *post;
};//需要注意的是，就是在ngx_http_hello_commands这个数组定义的最后，都要加一个ngx_null_command作为结尾
#define ngx_null_command  { ngx_null_string, 0, NULL, 0, 0, NULL }

typedef struct
{//在创建和读取该模块的配置信息之前被调用ngx_int_t   (*preconfiguration)(ngx_conf_t *cf);//在创建和读取该模块的配置信息之后被调用ngx_int_t   (*postconfiguration)(ngx_conf_t *cf);//调用该函数创建本模块位于http block的配置信息存储结构。该函数成功的时候，返回创建的配置对象。失败的话，返回NULLvoid       *(*create_main_conf)(ngx_conf_t *cf);//调用该函数初始化本模块位于http block的配置信息存储结构。该函数成功的时候，返回NGX_CONF_OK。失败的话，返回NGX_CONF_ERROR或错误字符串char       *(*init_main_conf)(ngx_conf_t *cf, void *conf);//调用该函数创建本模块位于http server block的配置信息存储结构，每个server block会创建一个。该函数成功的时候，返回创建的配置对象。失败的话，返回NULLvoid       *(*create_srv_conf)(ngx_conf_t *cf);//因为有些配置指令既可以出现在http block，也可以出现在http server block中。那么遇到这种情况，每个server都会有自己存储结构来存储该server的配置，但是在这种情况下http block中的配置与server block中的配置信息发生冲突的时候，就需要调用此函数进行合并，该函数并非必须提供，当预计到绝对不会发生需要合并的情况的时候，就无需提供。当然为了安全起见还是建议提供。该函数执行成功的时候，返回NGX_CONF_OK。失败的话，返回NGX_CONF_ERROR或错误字符串char       *(*merge_srv_conf)(ngx_conf_t *cf, void *prev, void *conf);//调用该函数创建本模块位于location block的配置信息存储结构。每个在配置中指明的location创建一个。该函数执行成功，返回创建的配置对象。失败的话，返回NULLvoid       *(*create_loc_conf)(ngx_conf_t *cf);//与merge_srv_conf类似，这个也是进行配置值合并的地方。该函数成功的时候，返回NGX_CONF_OK。失败的话，返回NGX_CONF_ERROR或错误字符串char       *(*merge_loc_conf)(ngx_conf_t *cf, void *prev, void *conf);
} ngx_http_module_t;

#define NGX_CONF_UNSET       -1
#define NGX_CONF_UNSET_UINT  (ngx_uint_t) -1
#define NGX_CONF_UNSET_PTR   (void *) -1
#define NGX_CONF_UNSET_SIZE  (size_t) -1
#define NGX_CONF_UNSET_MSEC  (ngx_msec_t) -1

typedef struct ngx_module_s      ngx_module_t;
struct ngx_module_s {ngx_uint_t            ctx_index;ngx_uint_t            index;ngx_uint_t            spare0;ngx_uint_t            spare1;ngx_uint_t            abi_compatibility;ngx_uint_t            major_version;ngx_uint_t            minor_version;void                 *ctx;ngx_command_t        *commands;ngx_uint_t            type;ngx_int_t           (*init_master)(ngx_log_t *log);ngx_int_t           (*init_module)(ngx_cycle_t *cycle);ngx_int_t           (*init_process)(ngx_cycle_t *cycle);ngx_int_t           (*init_thread)(ngx_cycle_t *cycle);void                (*exit_thread)(ngx_cycle_t *cycle);void                (*exit_process)(ngx_cycle_t *cycle);void                (*exit_master)(ngx_cycle_t *cycle);uintptr_t             spare_hook0;uintptr_t             spare_hook1;uintptr_t             spare_hook2;uintptr_t             spare_hook3;uintptr_t             spare_hook4;uintptr_t             spare_hook5;uintptr_t             spare_hook6;uintptr_t             spare_hook7;
};#define NGX_NUMBER_MAJOR  3
#define NGX_NUMBER_MINOR  1
#define NGX_MODULE_V1          0, 0, 0, 0,                              \NGX_DSO_ABI_COMPATIBILITY, NGX_NUMBER_MAJOR, NGX_NUMBER_MINOR
#define NGX_MODULE_V1_PADDING  0, 0, 0, 0, 0, 0, 0, 0

http://tengine.taobao.org/book/chapter_03.html

1. wget https://codeload.github.com/nginx/nginx/zip/master
2. cd /usr/local/nginx/nginx-master
3. ./auto/configure --prefix=/usr/local/nginx
make
make install//启动nginx
/usr/local/nginx/sbin/nginx//Nginx默认以Deamon进程启动
curl -i http://localhost///停止Nginx
/usr/local/nginx/sbin/nginx -s stop

#user  nobody;
worker_processes  1;error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;pid        logs/nginx.pid;events {worker_connections  1024;
} http {include       mime.types;default_type  application/octet-stream;#log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '#                  '$status $body_bytes_sent "$http_referer" '#                  '"$http_user_agent" "$http_x_forwarded_for"';access_log  logs/access.log  main;sendfile        on;#tcp_nopush     on;#keepalive_timeout  0;keepalive_timeout  65;#gzip  on;server {listen       80;server_name  localhost;#charset koi8-r;#access_log  logs/host.access.log  main;location / {root   /usr/local/nginx/html;index  index.html index.htm;}#error_page  404              /404.html;# redirect server error pages to the static page /50x.html#error_page   500 502 503 504  /50x.html;location = /50x.html {root   html;}# proxy the PHP scripts to Apache listening on 127.0.0.1:80##location ~ \.php$ {#    proxy_pass   http://127.0.0.1;
        #}# pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000##location ~ \.php$ {#    root           html;#    fastcgi_pass   127.0.0.1:9000;#    fastcgi_index  index.php;#    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;#    include        fastcgi_params;#}# deny access to .htaccess files, if Apache's document root# concurs with nginx's one
        ##location ~ /\.ht {#    deny  all;#}}# another virtual host using mix of IP-, name-, and port-based configuration##server {#    listen       8000;#    listen       somename:8080;#    server_name  somename  alias  another.alias;#    location / {#        root   html;#        index  index.html index.htm;#    }#}# HTTPS server##server {#    listen       443 ssl;#    server_name  localhost;#    ssl_certificate      cert.pem;#    ssl_certificate_key  cert.key;#    ssl_session_cache    shared:SSL:1m;#    ssl_session_timeout  5m;#    ssl_ciphers  HIGH:!aNULL:!MD5;#    ssl_prefer_server_ciphers  on;#    location / {#        root   html;#        index  index.html index.htm;#    }#}}

指令名 参数1 参数2 … 参数N;
//注意参数间可用任意数量空格分隔，最后要加分号 

http://tengine.taobao.org/book/chapter_03.html

1. handler模块负责处理请求，完成响应内容的生成
2. filter模块对响应内容进行处理
//因此Nginx模块开发分为handler开发和filter开发(暂考虑load-balancer模块)

location /echo {echo "hello nginx";
}
//nginx根据conf配置文件来指导其自身的行为

1. 读入配置文件中echo指令及其参数
2. 进行HTTP包装(添加HTTP头等工作)
3. 将结果返回给客户端 

typedef struct {ngx_str_t  ed;
} ngx_http_echo_loc_conf_t;

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
};
//指令数组的命名规则为ngx_http_[module-name]_commands，注意数组最后一个元素要是ngx_null_command结束

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);//修改了核心模块配置（也就是这个location的配置），将其handler替换为我们编写的handler：ngx_http_echo_handler。这样就屏蔽了此location的默认handler，使用ngx_http_echo_handler产生HTTP响应
    clcf->handler = ngx_http_echo_handler;//调用ngx_conf_set_str_slot转化echo指令的参数
    ngx_conf_set_str_slot(cf,cmd,conf);return NGX_CONF_OK;
}

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 */
};

1. create_loc_conf用于初始化一个配置结构体，如为配置结构体分配内存等工作
2. merge_loc_conf用于将其父block的配置信息合并到此结构体中，也就是实现配置的继承
//这两个函数会被Nginx自动调用。注意这里的命名规则：ngx_http_[module-name]_[create|merge]_[main|srv|loc]_conf 

static void *ngx_http_echo_create_loc_conf(ngx_conf_t *cf)
{ngx_http_echo_loc_conf_t  *conf;//ngx_pcalloc用于在Nginx内存池中分配一块空间，是pcalloc的一个包装。使用ngx_pcalloc分配的内存空间不必手工free，Nginx会自行管理，在适当是否释放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;//create_loc_conf新建一个ngx_http_echo_loc_conf_t，分配内存，并初始化其中的数据，然后返回这个结构的指针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, "");//merge_loc_conf将父block域的配置信息合并到create_loc_conf新建的配置结构体中return NGX_CONF_OK;
}

1. 读入模块配置
2. 处理功能业务
3. 产生HTTP header
4. 产生HTTP body 

/*
* Copyright (C) Eric Zhang
*/
#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 */
//完成了Nginx模块各种组件的开发下面就是将这些组合起来了。一个Nginx模块被定义为一个ngx_module_t结构
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 */
//handler会接收一个ngx_http_request_t指针类型的参数，这个参数指向一个ngx_http_request_t结构体，此结构体存储了这次HTTP请求的一些信息
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;}//设置response headerr->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;//使用ngx_http_send_header就可以将头信息输出rc = ngx_http_send_header(r);if(rc != NGX_OK){return rc;}/*最后一步也是最重要的一步是输出Response body，Nginx允许handler一次产生一组输出，可以产生多次，Nginx将输出组织成一个单链表结构struct ngx_chain_s {ngx_buf_t    *buf;ngx_chain_t  *next;};其中ngx_chain_t是ngx_chain_s的别名，buf为某个数据缓冲区的指针，next指向下一个链表节点，可以看到这是一个非常简单的链表ngx_buf_t的定义比较长而且很复杂，这里就不贴出来了，请自行参考core/ngx_buf.h。ngx_but_t中比较重要的是pos和last，分别表示要缓冲区数据在内存中的起始地址和结尾地址，这里我们将配置中字符串传进去，last_buf是一个位域，设为1表示此缓冲区是链表中最后一个元素，为0表示后面还有元素。因为我们只有一组数据，所以缓冲区链表中只有一个节点，如果需要输入多组数据可将各组数据放入不同缓冲区后插入到链表缓冲数据准备好后，用ngx_http_output_filter就可以输出了(会送到filter进行各种过滤处理)*/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;
}

1. cd  /usr/local/nginx/nginx-master/src/http/modules/
2. mkdir ngx_http_echo_module
3. cd ngx_http_echo_module
4. vim /usr/local/nginx/nginx-master/src/http/modules/ngx_http_echo_module/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"
*/5. cd /usr/local/nginx/nginx-master
6. ./auto/configure --prefix=/usr/local/nginx/ --add-module=/usr/local/nginx/nginx-master/src/http/modules/ngx_http_echo_module/
7. make
8. make install
9. vim /usr/local/nginx/conf/nginx.conf
//编辑增加
location /echo {echo "hello nginx";
}10. 重启
/usr/local/nginx/sbin/nginx -s stop
/usr/local/nginx/sbin/nginx  11. 访问
http://121.40.254.73/echo

http://blog.codinglabs.org/articles/intro-of-nginx-module-development.html
http://blog.csdn.net/poechant/article/details/7627828
http://bg.biedalian.com/2013/08/09/nginx-hello-world.html