nginx modules guide cnsu.pdfVIP

Emiller 的Nginx 模块开发指南 作者：Evan Miller 草稿: 2009年 8 月 13 日 译者：姚伟斌 草稿：2009 年 9 月21 内容目录 0. 预备知识1 1. Nginx 模块任务委派的主要轮廓1 2. Nginx 模块的组成3 2.1. 模块的配置结构体3 2.2. 模块的指令4 2.3. 模块的上下文6 2.3.1. 创建位置结构体（create_loc_conf ）8 2.3.2. 初始化结构体（merge_loc_conf）8 2.4. 模块定义9 2.5. 模块注册10 3. 处理模块、过滤模块和 负载均衡模块10 3.1. ( )10 剖析处理模块 非代理 3.1.1. 获得位置配置结构体10 3.1.2. 产生回复11 3.1.3. 发送 HTTP 头部12 3.1.4. 发送 HTTP 主体13 3.2. 上游模块剖析（又称代理模块）14 i 3.2.1.代理模块回调函数的概要14 3.2.2. create_request 回调函数16 3.2.3. process_header 回调函数17 3.2.4. 状态保持18 3.3.处理模块的注册19 4 过滤模块19 4.1. 剖析头部过滤函数19 4.2. 剖析主体过滤函数20 4.3 过滤函数的注册22 5. 剖析负载均衡模块24 5.1.激活指令24 5.2.注册函数25 5.3.上游主机初始化函数27 5.4. 同伴初始化函数28 5.5.负载均衡函数30 5.6. 同伴释放函数31 6. 完成并编译自定义模块32 7.高级话题33 中文版本修改日志33 ii iii 翻译说明： 在 nginx 的模块编写过程中，时常苦于文档的不足，而源代码中又没多少注 释。只有 Emiller 的这篇英文文档带我入门，在自己研读的过程中，就想将其翻 译出来，让其他人能快速的浏览，但是如果你想更深入的进入 nginx 的代码开发， 最好是多读 nginx 的代码。因其内部的代码是经常改变的，所以本文有可能已经 过时。 由于本人英语水平一般，接触Nginx 时间不多，翻译中碰到的错误在所难免， 如果您觉得哪里翻译得不对，请跟我联系：yaoweibin2008@163.com 翻译词汇对照表： Backend：后端服务器。 Buffer：缓冲区。 Callback ：回调函数，一般来说是将某个回调函数赋值给某个函数指针 CHAIN OF RESPONSIBILITY ：接力链表。 Context ：上下文，有前后工作环境的意思，主要是前期配置值初始化。 Filter / ：过滤模块 函数，模块和函数的概念似乎有点模糊不清。 Handler: / 处理模块 函数，另外也有指向具体的处理函数的指针或句柄的意思。 Installation：原意为安装，我觉得还是译作注册好点。 Load-balancer / ：负载均衡模块 函数。 Location /photo/ /photo” ：指目录位置，比如