前　言 第一部分　Nginx能帮我们做什么 第1章　研究Nginx前的准备工作 / 2 1.1　Nginx是什么 / 2 1.2　为什么选择Nginx / 4 1.3　准备工作 / 7 1.3.1　Linux操作系统 / 7 1.3.2　使用Nginx的必备软件 / 7 1.3.3　磁盘目录 / 8 1.3.4　Linux内核参数的优化 / 9 1.3.5　获取Nginx源码 / 11 1.4　编译安装Nginx / 11 1.5　configure详解 / 11 1.5.1　configure的命令参数 / 12 1.5.2　configure执行流程 / 18 1.5.3　configure生成的文件 / 22 1.6　Nginx的命令行控制 / 24 1.7　小结 / 27 第2章　Nginx的配置 / 28 2.1　运行中的Nginx进程间的关系 / 28 2.2　Nginx配置的通用语法 / 31 2.2.1　块配置项 / 31 2.2.2　配置项的语法格式 / 32 2.2.3　配置项的注释 / 33 2.2.4　配置项的单位 / 33 2.2.5　在配置中使用变量 / 33 2.3　Nginx服务的基本配置 / 34 2.3.1　用于调试进程和定位问题的配置项 / 34 2.3.2　正常运行的配置项 / 36 2.3.3　优化性能的配置项 / 38 2.3.4　事件类配置项 / 39 2.4　用HTTP核心模块配置一个静态Web服务器 / 41 2.4.1　虚拟主机与请求的分发 / 42 2.4.2　文件路径的定义 / 45 2.4.3　内存及磁盘资源的分配 / 48 2.4.4　网络连接的设置 / 50 2.4.5　MIME类型的设置 / 53 2.4.6　对客户端请求的限制 / 54 2.4.7　文件操作的优化 / 55 2.4.8　对客户端请求的特殊处理 / 57 2.4.9　ngx_http_core_module模块提供的变量 / 59 2.5　用HTTP proxy module配置一个反向代理服务器 / 60 2.5.1　负载均衡的基本配置 / 62 2.5.2　反向代理的基本配置 / 64 2.6　小结 / 68 第二部分　如何编写HTTP模块 第3章　开发一个简单的HTTP模块 / 70 3.1　如何调用HTTP模块 / 70 3.2　准备工作 / 72 3.2.1　整型的封装 / 72 3.2.2　ngx_str_t数据结构 / 73 3.2.3　ngx_list_t数据结构 / 73 3.2.4　ngx_table_elt_t数据结构 / 77 3.2.5　ngx_buf_t数据结构 / 77 3.2.6　ngx_chain_t数据结构 / 79 3.3　如何将自己的HTTP模块编译进Nginx / 79 3.3.1　config文件的写法 / 80 3.3.2　利用configure脚本将定制的模块加入到Nginx中 / 80 3.3.3　直接修改Makefile文件 / 84 3.4　HTTP模块的数据结构 / 85 3.5　定义自己的HTTP模块 / 88 3.6　处理用户请求 / 92 3.6.1　处理方法的返回值 / 92 3.6.2　获取URI和参数 / 95 3.6.3　获取HTTP头部 / 98 3.6.4　获取HTTP包体 / 101 3.7　发送响应 / 102 3.7.1　发送HTTP头部 / 102 3.7.2　将内存中的字符串作为包体发送 / 104 3.7.3　经典的“Hello World”示例 / 106 3.8　将磁盘文件作为包体发送 / 107 3.8.1　如何发送磁盘中的文件 / 107 3.8.2　清理文件句柄 / 110 3.8.3　支持用户多线程下载和断点续传 / 111 3.9　用C++语言编写HTTP模块 / 112 3.9.1　编译方式的修改 / 112 3.9.2　程序中的符号转换 / 114 3.10　小结 / 114 第4章　配置、error日志和请求上下文 / 115 4.1　http配置项的使用场景 / 115 4.2　怎样使用http配置 / 117 4.2.1　分配用于保存配置参数的数据结构 / 117 4.2.2　设定配置项的解析方式 / 119 4.2.3　使用14种预设方法解析配置项 / 125 4.2.4　自定义配置项处理方法 / 136 4.2.5　合并配置项 / 137 4.3　HTTP配置模型 / 140 4.3.1　解析HTTP配置的流程 / 141 4.3.2　HTTP配置模型的内存布局 / 144 4.3.3　如何合并配置项 / 147 4.3.4　预设配置项处理方法的工作原理 / 149 4.4　error日志的用法 / 150 4.5　请求的上下文 / 155 4.5.1　上下文与全异步Web服务器的关系 / 155 4.5.2　如何使用HTTP上下文 / 156 4.5.3　HTTP框架如何维护上下文结构 / 157 4.6　小结 / 158 第5章　访问第三方服务 / 159 5.1　upstream的使用方式 / 160 5.1.1　ngx_http_upstream_t结构体 / 163 5.1.2　设置upstream的限制性参数 / 164 5.1.3　设置需要访问的第三方服务器地址 / 165 5.1.4　设置回调方法 / 166 5.1.5　如何启动upstream机制 / 166 5.2　回调方法的执行场景 / 167 5.2.1　create_request回调方法 / 167 5.2.2　reinit_request回调方法 / 169 5.2.3　finalize_request回调方法 / 170 5.2.4　process_header回调方法 / 171 5.2.5　rewrite_redirect回调方法 / 172 5.2.6　input_filter_init与input_filter回调方法 / 172 5.3　使用upstream的示例 / 173 5.3.1　upstream的各种配置参数 / 174 5.3.2　请求上下文 / 175 5.3.3　在create_request方法中构造请求 / 176 5.3.4　在process_header方法中解析包头 / 177 5.3.5　在finalize_request方法中释放资源 / 180 5.3.6　在ngx_http_mytest_handler方法中启动upstream / 181 5.4　subrequest的使用方式 / 183 5.4.1　配置子请求的处理方式 / 183 5.4.2　实现子请求处理完毕时的回调方法 / 184 5.4.3　处理父请求被重新激活后的回调方法 / 185 5.4.4　启动subrequest子请求 / 185 5.5　subrequest执行过程中的主要场景 / 186 5.5.1　如何启动subrequest / 186 5.5.2　如何转发多个子请求的响应包体 / 188 5.5.3　子请求如何激活父请求 / 192 5.6　subrequest使用的例子 / 193 5.6.1　配置文件中子请求的设置 / 194 5.6.2　请求上下文 / 194 5.6.3　子请求结束时的处理方法 / 195 5.6.4　父请求的回调方法 / 196 5.6.5　启动subrequest / 197 5.7　小结 / 198 第6章　开发一个简单的HTTP过滤模块 / 199 6.1　过滤模块的意义 / 199 6.2　过滤模块的调用顺序 / 200 6.2.1　过滤链表是如何构成的 / 200 6.2.2　过滤链表的顺序 / 203 6.2.3　官方默认HTTP过滤模块的功能简介 / 204 6.3　HTTP过滤模块的开发步骤 / 206 6.4　HTTP过滤模块的简单例子 / 207 6.4.1　如何编写config文件 / 208 6.4.2　配置项和上下文 / 208 6.4.3　定义HTTP过滤模块 / 210 6.4.4　初始化HTTP过滤模块 / 211 6.4.5　处理请求中的HTTP头部 / 212 6.4.6　处理请求中的HTTP包体 / 213 6.5　小结 / 214 第7章　Nginx提供的高级数据结构 / 215 7.1　Nginx提供的高级数据结构概述 / 215 7.2　ngx_queue_t双向链表 / 217 7.2.1　为什么设计ngx_queue_t双向链表 / 217 7.2.2　双向链表的使用方法 / 217 7.2.3　使用双向链表排序的例子 / 219 7.2.4　双向链表是如何实现的 / 221 7.3　ngx_array_t动态数组 / 222 7.3.1　为什么设计ngx_array_t动态数组 / 223 7.3.2　动态数组的使用方法 / 223 7.3.3　 使用动态数组的例子 / 225 7.3.4　动态数组的扩容方式 / 226 7.4　ngx_list_t单向链表 / 226 7.5　ngx_rbtree_t红黑树 / 227 7.5.1　为什么设计ngx_rbtree_t红黑树 / 227 7.5.2　红黑树的特性 / 228 7.5.3　红黑树的使用方法 / 230 7.5.4　使用红黑树的简单例子 / 233 7.5.5　如何自定义添加成员方法 / 234 7.6　ngx_radix_tree_t基数树 / 236 7.6.1　ngx_radix_tree_t基数树的原理 / 236 7.6.2　基数树的使用方法 / 238 7.6.3　使用基数树的例子 / 239 7.7　支持通配符的散列表 / 240 7.7.1　ngx_hash_t基本散列表 / 240 7.7.2　支持通配符的散列表 / 243 7.7.3　带通配符散列表的使用例子 / 250 7.8　小结 / 254 第三部分　深入Nginx 第8章　Nginx基础架构 / 256 8.1　Web服务器设计中的关键约束 / 256 8.2　Nginx的架构设计 / 259 8.2.1　优秀的模块化设计 / 259 8.2.2　事件驱动架构 / 263 8.2.3　请求的多阶段异步处理 / 264 8.2.4　管理进程、多工作进程设计 / 267 8.2.5　平台无关的代码实现 / 268 8.2.6　内存池的设计 / 268 8.2.7　使用统一管道过滤器模式的HTTP过滤模块 / 268 8.2.8　其他一些用户模块 / 269 8.3　Nginx框架中的核心结构体ngx_cycle_t / 269 8.3.1　ngx_listening_t结构体 / 269 8.3.2　ngx_cycle_t结构体 / 271 8.3.3　ngx_cycle_t支持的方法 / 273 8.4　Nginx启动时框架的处理流程 / 275 8.5　worker进程是如何工作的 / 278 8.6　master进程是如何工作的 / 281 8.7　小结 / 286 第9章　事件模块 / 287 9.1　事件处理框架概述 / 287 9.2　Nginx事件的定义 / 290 9.3　Nginx连接的定义 / 293 9.3.1　被动连接 / 294 9.3.2　主动连接 / 297 9.3.3　ngx_connection_t连接池 / 298 9.4　ngx_events_module核心模块 / 300 9.4.1　如何管理所有事件模块的配置项 / 301 9.4.2　管理事件模块 / 303 9.5　ngx_event_core_module事件模块 / 305 9.6　epoll事件驱动模块 / 310 9.6.1　epoll的原理和用法 / 311 9.6.2　如何使用epoll / 313 9.6.3　ngx_epoll_module模块的实现 / 315 9.7　定时器事件 / 323 9.7.1　缓存时间的管理 / 324 9.7.2　缓存时间的精度 / 326 9.7.3　定时器的实现 / 327 9.8　事件驱动框架的处理流程 / 328 9.8.1　如何建立新连接 / 329 9.8.2　如何解决“惊群”问题 / 330 9.8.3　如何实现负载均衡 / 333 9.8.4　post事件队列 / 334 9.8.5　ngx_process_events_and_timers流程 / 335 9.9　文件的异步I/O / 338 9.9.1　Linux内核提供的文件异步I/O / 339 9.9.2　ngx_epoll_module模块中实现的针对文件的异步I/O / 342 9.10　小结 / 346 第10章　HTTP框架的初始化 / 347 10.1　HTTP框架概述 / 348 10.2　管理HTTP模块的配置项 / 351 10.2.1　管理main级别下的配置项 / 352 10.2.2　管理server级别下的配置项 / 354 10.2.3　管理location级别下的配置项 / 357 10.2.4　不同级别配置项的合并 / 362 10.3　监听端口的管理 / 367 10.4　server的快速检索 / 369 10.5　location的快速检索 / 371 10.6　HTTP请求的11个处理阶段 / 372 10.6.1　HTTP处理阶段的普适规则 / 374 10.6.2　NGX_HTTP_POST_READ_PHASE阶段 / 376 10.6.3　NGX_HTTP_SERVER_REWRITE_PHASE阶段 / 378 10.6.4　NGX_HTTP_FIND_CONFIG_PHASE阶段 / 379 10.6.5　NGX_HTTP_REWRITE_PHASE阶段 / 379 10.6.6　NGX_HTTP_POST_REWRITE_PHASE阶段 / 379 10.6.7　NGX_HTTP_PREACCESS_PHASE阶段 / 379 10.6.8　NGX_HTTP_ACCESS_PHASE阶段 / 380 10.6.9　NGX_HTTP_POST_ACCESS_PHASE阶段 / 380 10.6.10　NGX_HTTP_TRY_FILES_PHASE阶段 / 381 10.6.11　NGX_HTTP_CONTENT_PHASE阶段 / 381 10.6.12　NGX_HTTP_LOG_PHASE阶段 / 382 10.7　HTTP框架的初始化流程 / 383 10.8　小结 / 385 第11章　HTTP框架的执行流程 / 386 11.1　HTTP框架执行流程概述 / 387 11.2　新连接建立时的行为 / 388 11.3　第一次可读事件的处理 / 390 11.4　接收HTTP请求行 / 396 11.5　接收HTTP头部 / 399 11.6　处理HTTP请求 / 403 11.6.1　ngx_http_core_generic_phase / 409 11.6.2　ngx_http_core_rewrite_phase / 411 11.6.3　ngx_http_core_access_phase / 412 11.6.4　ngx_http_core_content_phase / 415 11.7　subrequest与post请求 / 419 11.8　处理HTTP包体 / 421 11.8.1　接收包体 / 422 11.8.2　放弃接收包体 / 429 11.9　发送HTTP响应 / 433 11.9.1　ngx_http_send_header / 434 11.9.2　ngx_http_output_filter / 436 11.9.3　ngx_http_writer / 440 11.10　结束HTTP请求 / 442 11.10.1　ngx_http_close_connection / 443 11.10.2　ngx_http_free_request / 444 11.10.3　ngx_http_close_request / 446 11.10.4　ngx_http_finalize_connection / 447 11.10.5　ngx_http_terminate_request / 447 11.10.6　ngx_http_finalize_request / 448 11.11　小结 / 452 第12章　upstream机制的设计与实现 / 453 12.1　upstream机制概述 / 453 12.1.1　设计目的 / 454 12.1.2　ngx_http_upstream_t数据结构的意义 / 456 12.1.3　ngx_http_upstream_conf_t配置结构体 / 459 12.2　启动upstream / 462 12.3　与上游服务器建立连接 / 464 12.4　发送请求到上游服务器 / 467 12.5　接收上游服务器的响应头部 / 470 12.5.1　应用层协议的两段划分方式 / 470 12.5.2　处理包体的3种方式 / 471 12.5.3　接收响应头部的流程 / 473 12.6　不转发响应时的处理流程 / 476 12.6.1　input_filter方法的设计 / 477 12.6.2　默认的input_filter方法 / 478 12.6.3　接收包体的流程 / 479 12.7　以下游网速优先来转发响应 / 481 12.7.1　转发响应的包头 / 482 12.7.2　转发响应的包体 / 484 12.8　以上游网速优先来转发响应 / 489 12.8.1　ngx_event_pipe_t结构体的意义 / 489 12.8.2　转发响应的包头 / 493 12.8.3　转发响应的包体 / 495 12.8.4　ngx_event_pipe_read_upstream方法 / 498 12.8.5　ngx_event_pipe_write_to_downstream方法 / 502 12.9　结束upstream请求 / 504 12.10　小结 / 508 第13章　邮件代理模块 / 509 13.1　邮件代理服务器的功能 / 509 13.2　邮件模块的处理框架 / 512 13.2.1　一个请求的8个独立处理阶段 / 512 13.2.2　邮件类模块的定义 / 514 13.2.3　邮件框架的初始化 / 516 13.3　初始化请求 / 517 13.3.1　描述邮件请求的ngx_mail_session_t结构体 / 517 13.3.2　初始化邮件请求的流程 / 519 13.4　接收并解析客户端请求 / 520 13.5　邮件认证 / 520 13.5.1　ngx_mail_auth_http_ctx_t结构体 / 520 13.5.2　与认证服务器建立连接 / 522 13.5.3　发送请求到认证服务器 / 522 13.5.4　接收并解析响应 / 525 13.6　与上游邮件服务器间的认证交互 / 526 13.6.1　ngx_mail_proxy_ctx_t结构体 / 526 13.6.2　向上游邮件服务器发起连接 / 527 13.6.3　与邮件服务器认证交互的过程 / 528 13.7　透传上游邮件服务器与客户端间的流 / 530 13.8　小结 / 535 第14章　进程间的通信机制 / 536 14.1　概述 / 536 14.2　共享内存 / 536 14.3　原子操作 / 541 14.3.1　不支持原子库下的原子操作 / 541 14.3.2　x86架构下的原子操作 / 542 14.3.3　自旋锁 / 545 14.4　Nginx频道 / 546 14.5　信号 / 549 14.6　信号量 / 551 14.7　文件锁 / 553 14.8　互斥锁 / 556 14.8.1　文件锁实现的ngx_shmtx_t锁 / 558 14.8.2　原子变量实现的ngx_shmtx_t锁 / 560 14.9　小结 / 565