皮皮网

1.NGINX脚本语言原理及源码分析(一)
2.Nginx源码分析 - 主流程篇 - Nginx的码分启动流程
3.Nginx源码分析 - HTTP模块篇 - TCP连接建立过程
4.Nginx源码分析 - 主流程篇 - 全局变量cycle初始化
5.Nginx源码分析 - Event事件篇 - Epoll事件模块
6.nginx源码分析--master和worker进程模型

NGINX脚本语言原理及源码分析(一)

       NGINX提供了灵活的脚本解析功能，通过配置文件中的码分变量和指令实现特定功能。变量和指令是码分编程的基础，如若使用脚本语言，码分能提升配置的码分可扩展性，避免频繁添加新代码。码分checkstyle源码

       深入理解NGINX脚本语言，码分首先从变量的码分基本特性开始。在NGINX中，码分除了特殊类型的码分binary_remote_addr外，所有变量默认为字符串类型。码分变量名由美元符号或花括号包围，码分只接受特定字符（a-z、码分A-Z、码分0-9、码分_）。变量插入示例中，如set $def “this is a test $abc”，变量值会根据其他变量计算后再拼接。

       NGINX变量分为内置和自定义两种，自定义变量由特定模块定义，如rewrite和geo模块。内置变量广泛覆盖系统、网络、四层、SSL/TLS和HTTP层信息，部分动态变量如arg_根据HTTP请求参数动态生成。

       变量的作用域非常重要，未定义的变量在启动时会引发错误。全局可见的升降线公式源码变量允许跨location使用，但每个请求有自己的变量实例。变量的可变性通过标记控制，如内置变量通常不可变，但如$args和$limit_rate可变。

       关于缓存，变量的get_handler方法决定其是否实时计算。动态变量如$arg_name不可缓存，而set指令定义的变量可缓存。结合使用时，如"name"和"arg_name"可能产生不同结果，因为前者缓存，后者每次都从参数解析。

       变量的隔离性基于请求，同一变量在不同请求间独立，如同C语言的局部和全局变量。NGINX内，变量值容器随请求而变化，与location无关。

       后续文章将详细解析变量的实现原理和在脚本中的运用。对于更全面的NGINX资源，可访问NGINX开源社区获取。

Nginx源码分析 - 主流程篇 - Nginx的启动流程

       深入解析Nginx的核心，理解基础数据结构对源码解读至关重要。主流程的精髓隐藏在nginx.c的main()函数中，它启动的每一个步骤都如同乐谱上的一段旋律，优雅而有序。

       启动乐章

       首先，指挥棒落在ngx_get_options上，它如同乐团指挥，搜索分类的源码优雅地解析启动命令行参数。接着，ngx_time_init、ngx_getpid和ngx_log_init依次登场，为时间、进程标识和日志设置调音。它们共同完成了一次细致入微的初始化过程，为接下来的演出铺平道路。

       紧接着，ngx_init_cycle指挥全局变量的诞生，包括一致性哈希表的初始化，以及处理系统变量的微妙操作。随后，它引导我们进入一个关键环节：继承socket，初始化模块，设置信号处理，配置文件的获取和pid文件的创建，如同交响乐中的序曲，为后续的进程管理做准备。

       乐章高潮

       当进入ngx_master_process_cycle部分，主进程的魔法开始显现。它如魔术师般，通过创建子进程，让各个模块和事件监听开始各自的旋律。在这里，每个参数处理都如同精心编排的音符，确保演奏的和谐。

       关键步骤

       在ngx_get_options中，启动命令参数如-s stop/start/restart的客户信息采集源码解读，是理解Nginx行为的关键。而在幕后，ngx_save_argv负责存储这些参数，ngx_process_options则如同指挥家，将参数的魔力注入到ngx_cycle的结构中。

       特别关注的全局变量，如ngx_show_help、ngx_conf_file，它们是Nginx运行的调色板。ngx_save_argv和ngx_process_options如同调色师，精心调配每个参数的色彩。

       模块初始化的序曲

       ngx_preinit_modules是模块世界的序曲，它负责初始化配置路径、处理参数，以及配置文件的定位。在这里，每个动作都精确而有序，确保每个模块都能在正确的时间奏响属于自己的旋律。

       在ngx_module.c中，模块编号的分配和配置文件的处理，如同管弦乐队的编排，确保每个乐器都能和谐共奏。而创建PID文件的函数ngx_create_pidfile则如定音锤，为整个系统敲定最后的音符。

       每个重要模块，如ngx_add_inherited_sockets、ngx_init_cycle、ngx_signal_process和ngx_master_process_cycle，都在各自的流控源码下载角色中发挥着不可或缺的作用，共同编织出Nginx启动的华美乐章。

Nginx源码分析 - HTTP模块篇 - TCP连接建立过程

       Nginx源码分析 - HTTP模块篇 - TCP连接建立过程

       在上一章节中，我们已经了解了HTTP模块的初始化过程。本章节将深入剖析监听套接字的初始化函数以及Nginx连接的全程流程。

       首先， ngx_mands: epoll模块命令集

       ngx_epoll_module_ctx: epoll模块上下文

       ngx_epoll_module: epoll模块配置

       二、epoll模块的初始化

       在配置文件初始化阶段，epoll模块的初始化工作主要在核心函数 ngx_events_block 中完成。

       随后，ngx_event_process_init 函数负责执行模块的初始化操作，ngx_epoll_init 用于具体实现epoll模块的初始化。

       三、核心函数

       epoll模块的关键功能体现在 ngx_epoll_process_events 函数，此函数实现了事件的收集和分发功能，是Nginx处理事件的核心。

       以上是对Nginx源码中epoll事件模块的简要分析。

nginx源码分析--master和worker进程模型

       一、Nginx整体架构

       正常执行中的nginx会有多个进程，其中最基本的是master process（主进程）和worker process（工作进程），还可能包括cache相关进程。

       二、核心进程模型

       启动nginx的主进程将充当监控进程，主进程通过fork()产生的子进程则充当工作进程。

       Nginx也支持单进程模型，此时主进程即是工作进程，不包含监控进程。

       核心进程模型框图如下：

       master进程

       监控进程作为整个进程组与用户的交互接口，负责监护进程，不处理网络事件，不负责业务执行，仅通过管理worker进程实现重启服务、平滑升级、更换日志文件、配置文件实时生效等功能。

       master进程通过sigsuspend()函数调用大部分时间处于挂起状态，直到接收到信号。

       master进程通过检查7个标志位来决定ngx_master_process_cycle方法的运行：

       sig_atomic_t ngx_reap;

       sig_atomic_t ngx_terminate;

       sig_atomic_t ngx_quit;

       sig_atomic_t ngx_reconfigure;

       sig_atomic_t ngx_reopen;

       sig_atomic_t ngx_change_binary;

       sig_atomic_t ngx_noaccept;

       进程中接收到的信号对Nginx框架的意义：

       还有一个标志位：ngx_restart，仅在master工作流程中作为标志位使用，与信号无关。

       核心代码（ngx_process_cycle.c）：

       ngx_start_worker_processes函数：

       worker进程

       worker进程主要负责具体任务逻辑，主要关注与客户端或后端真实服务器之间的数据可读/可写等I/O交互事件，因此工作进程的阻塞点在select()、epoll_wait()等I/O多路复用函数调用处，等待数据可读/写事件。也可能被新收到的进程信号中断。

       master进程如何通知worker进程进行某些工作？采用的是信号。

       当收到信号时，信号处理函数ngx_signal_handler()会执行。

       对于worker进程的工作方法ngx_worker_process_cycle，它主要关注4个全局标志位：

       sig_atomic_t ngx_terminate;//强制关闭进程

       sig_atomic_t ngx_quit;//优雅地关闭进程（有唯一一段代码会设置它，就是接受到QUIT信号。ngx_quit只有在首次设置为1时，才会将ngx_exiting置为1）

       ngx_uint_t ngx_exiting;//退出进程标志位

       sig_atomic_t ngx_reopen;//重新打开所有文件

       其中ngx_terminate、ngx_quit、ngx_reopen都将由ngx_signal_handler根据接收到的信号来设置。ngx_exiting标志位仅由ngx_worker_cycle方法在退出时作为标志位使用。

       核心代码（ngx_process_cycle.c）：

NGINX Server匹配原理及源码分析

       NGINX服务器的匹配机制关键在于将用户请求转发到正确的server，分为两个步骤：首先根据请求的地址和端口，然后根据server_name进一步确定。本文将深入解析其配置指令、源码和匹配过程。

       配置指令是实现服务器匹配的关键，`listen`指令定义服务地址和端口，`server_name`则区分在相同地址和端口下的多个服务器。四层信息（地址和端口）由`listen`处理，七层信息（hostname和URL路径）则通过`server_name`和`location`指令来处理。

       `listen`指令的语法和注意事项需理解，如`default_server`和`flags`选项。`server_name`支持多种配置形式，匹配时遵循特定优先级。服务器的匹配过程可通过举例来理解，例如，完全匹配、前缀和后缀通配、正则表达式匹配等规则。

       源代码层面，涉及的数据结构如ngx_listening_t、ngx_http_port_t等在解析配置指令时起关键作用。`ngx_http_core_listen`和`ngx_http_core_server_name`函数负责指令的具体解析。在创建监听端口时，会根据配置生成多个ngx_listen_t，将服务器与地址和端口关联。

       用户连接到达后，数据层面的源码分析揭示了服务器匹配的执行过程。通过一系列函数和数据结构，最终确定了请求应被转发到哪个server。

       总结，NGINX的服务器匹配机制是其功能的核心，通过理解配置和源码，可以更深入地掌握其工作原理。后续文章将探讨location匹配的细节。

Nginx源码分析 - Event事件篇 - Event模块和配置的初始化

       深入探讨Nginx源码分析中的Event事件篇，专注于Event模块和配置的初始化，旨在清晰理解配置解析与模块初始化的协同工作。

       Event模块的配置解析分为两层：最外层的events模块以及内层的ngx_events_module事件模块和ngx_event_core_module事件核心模块。

       在初始化流程中，最开始配置文件的初始化调用的是核心模块的指令集，即events模块的配置解析指令函数：ngx_events_block。这里涉及的事件模块结构主要包括：事件模块本身和事件核心模块，每层模块拥有特定的角色与功能。

       具体而言，事件核心模块初始化函数为ngx_event_module_init，而配置解析流程则始于解析顶层“event”的配置，并通过ngx_conf_parse方法实现。在顶层配置解析完成后，将进入对事件块block中的内容解析，即ngx_events_block方法执行，此方法为事件命令集的回调函数，负责核心模块配置信息的创建。

       配置初始化中，首先在ngx_init_cycle方法中完成核心模块初始化，但由于ngx_events_module中的create_conf方法为NULL，故不会调用创建配置的步骤。接着，顶层配置解析完成后，进入事件块block内容解析，通过遍历模块命令集cmd->set方法，完成具体配置的创建与初始化。

       在配置获取过程中，首先从ngx_events_module获取配置信息，再通过查找找到ngx_event_core_module的配置信息。配置的获取涉及从事件模块到事件核心模块的层级访问，确保配置信息的准确获取。

       综上所述，Event事件篇中的模块和配置初始化通过多层解析与调用，确保了Nginx配置的完整执行与模块功能的有效实现。这一过程不仅涉及配置的层次结构，还涉及到初始化函数的精确调用与配置解析的细致处理，体现了Nginx源码设计的严谨与高效。

Nginx源码分析 - HTTP模块篇 - HTTP Request解析过程

       深入解析Nginx HTTP模块的HTTP Request解析过程，从ngx_http_wait_request_handler函数开始，直至解析完成。解析流程如下：

       首先，Nginx通过ngx_http_wait_request_handler等待HTTP请求数据，设计亮点在于其能连续等待TCP管道中的数据，直至触发read事件，且在未读取数据时自动清理buf内存，有效防止内存暴涨。

       接下来，ngx_http_process_request_line与ngx_http_read_request_header共同解析请求行与头部信息。其中，ngx_http_read_request_header使用系统的recv函数循环接收数据，通过回调函数os/ngx_recv完成。

       随后，ngx_http_process_request_headers负责解析HTTP头部数据，如Host与Accept-Language等。

       ngx_http_process_request设定了read和write的回调函数ngx_http_request_handler，通过状态机判断事件类型，调用HTTP模块的filter链，包括header和body链两部分。filter链中，ngx_http_request_handler根据事件状态调用相应的回调函数。

       解析过程中，ngx_http_run_posted_requests用于处理子请求，将请求链内容合并到主请求上，尽管此过程可能会稍降性能，因为需要重新走一遍write的回调函数ngx_http_core_run_phases。

       最后，解析过程的核心在于ngx_http_handler函数，该函数主要用于设置write事件回调函数，即ngx_http_core_run_phases。

       至此，完整的HTTP Request解析流程在Nginx的HTTP模块中得以清晰展现。