进程模型
Rapira 运行一个 master 进程,并为每种启用的协议运行一个 worker 进程池。master 持有监听套接字、已初始化的 PHP 引擎和 pidfile,然后创建 worker 进程。每个 worker 继承 PHP,并从所属进程池的共享套接字接受连接。Rapira 不在进程之间传递请求。
HTTP 和 gRPC 有独立的监听器、入口脚本和进程池。[http.pool] 和 [grpc.pool] 分别配置它们。gRPC 进程池使用 Dispatcher 模式,每个 worker 同时处理一个活动调用。
当配置中有 [observability] 表时,master 还会为指标和健康检查启动一个进程。此进程不运行 PHP 代码。在 Linux 上,它的进程名为 rapira-obs,PHP worker 的进程名为 rapira-worker。master 与 PHP worker 一起监管和停止此进程。重载不会改变它,因为它没有需要重启的应用。更多内容见指标和健康检查。
在 Classic、Worker 和 Dispatcher 模式下,进程模型都相同。http.pool.mode 控制 worker 内部的请求处理。此设置不改变进程池的创建、监管或重载。更多内容见执行模式。
master 与 worker
初始化按以下顺序进行:
- 绑定一个或多个监听套接字。 端口冲突会在 PHP 启动前停止初始化。
- 只启动一次 PHP。 master 在它的单个线程中运行
MINIT。OPcache 此时创建它的共享内存,每个 worker 都继承这块内存。一个 worker 编译某个文件后,其他 worker 使用缓存的结果。 - fork 出 worker。 每个子进程继承已绑定的套接字和已初始化的引擎。
图中展示一个进程池。每个 worker 运行一个 NTS PHP 解释器和一个异步 HTTP 或 gRPC 服务器。服务器使用 hyper,在具有两个线程的私有 tokio 运行时上运行。每个 worker 在继承的套接字上调用 accept()。操作系统将每个新连接分配给一个 worker。
master 不处理请求。它的单个线程等待信号、worker 退出和定时器。
master 在整个生命周期中持有 PHP 模块。只有 master 关闭此模块。worker 退出时不关闭这份共享的引擎状态。
监管
master 每秒执行一次维护。worker 退出时,master 也会立即处理每次退出。
- 替换 worker。 worker 正常退出后,master 立即替换它。worker 崩溃或以不健康状态退出后,替换延迟从 100 ms 开始。每次连续故障后延迟翻倍,最大为 25.6 秒。worker 运行至少 10 秒会重置延迟。
- 启动失败。 在 Worker 和 Dispatcher 模式下,如果入口脚本在收到请求前结束,则启动失败。worker 随后最多等待 5 秒,然后再次运行入口脚本。等待期间到达的请求会收到 HTTP
503或 gRPCUNAVAILABLE。连续五次启动失败后,worker 以不健康状态退出。 - 启动失败时 master 停止。 如果不健康的 worker 退出,master 以退出码 70 停止。仅当进程池没有成功的请求,也没有空闲或活动的 worker 时,此规则才适用。在其他所有情况下,master 在替换延迟后替换 worker。worker 崩溃永远不会使 master 停止。
- 请求限制。 在 Worker 和 Dispatcher 模式下,
http.pool.max_requests限制一个应用实例的请求数。在处理max_requests + 1到大约1.5 × max_requests之间的随机数量请求后,worker 重启它的应用。worker 进程、它的连接和它的队列保持不变。下一个请求等待应用启动。随机范围可以避免同时重启。Classic 模式忽略此设置,因为每个请求都在新的 PHP 请求中运行。 - 请求超时。 使用
http.pool.request_terminate_timeout_secs时,如果 worker 的当前请求超过限制,master 向它发送SIGTERM。如果在下一次维护时 worker 仍处于活动状态,master 发送SIGKILL。然后 master 立即替换该 worker。master 在停止期间不应用此超时。 - 内存限制。 除停止期间外,master 每秒检查每个 worker 的 RSS,并在超过
http.pool.max_memory_mb时发送一次SIGQUIT。worker 停止接受新连接;现有连接可以在排空超时内收到下一个请求的响应。超过此超时的响应可能被截断。master 在 worker 退出后启动替代进程,退出会释放 PHP 内外的内存。应用重启后 RSS 可能仍然很高,因为 PHP 会保留部分已释放的内存以便重用。 - master 监控。 每个 worker 从 master 保持打开的管道中读取。如果 master 退出,每个 worker 停止接受新工作,完成当前请求,然后退出。
进程池大小
以下设置使用 [http.pool]。相同的设置也适用于 [grpc.pool]。
http.pool.processes 设置 worker 数量。master 在初始化期间创建这些 worker,并替换每个退出的 worker。默认值为进程可以使用的每个 CPU 一个 worker。如果容器有 CPU 限制,默认值遵循该限制。
所有进程池的 worker 总数必须不超过 4096。启用可观测性时,它的进程计为一个 worker。总数更大时,Rapira 以退出码 70 停止。
PHP 是同步的,因此每个 worker 一次处理一个请求。I/O 密集型应用可能需要比 CPU 核心更多的 worker。CPU 密集型应用通常不需要。
服务器运行期间,worker 数量不会改变。要根据负载改变容量,请改变 Rapira 实例的数量,例如使用容器编排器。
完整的键参考见配置。
信号
信号用来停止正在运行的服务器、重载它,以及让它报告自己的状态。所有信号都发给 master。
| 信号 | master 的动作 |
|---|---|
SIGTERM、SIGINT | master 让当前请求完成,然后停止 worker。第二个信号强制 worker 停止。 |
SIGQUIT | master 执行相同的受控停止。再发送 SIGQUIT 没有效果。 |
SIGUSR2、SIGHUP | master 通知每个 worker 重启它的应用。不替换任何 worker 进程。 |
SIGUSR1 | master 将进程池状态写入日志。 |
设置 supervisor.pidfile,脚本就可以从一个固定位置读取 master 的进程标识符:
kill -USR2 $(cat /run/rapira.pid) # 在每个 worker 中重启应用。
kill -USR1 $(cat /run/rapira.pid) # Write pool status to the log.
kill -TERM $(cat /run/rapira.pid) # Stop after current requests finish.仅向 master 发送信号。worker 会忽略 SIGUSR1。SIGUSR2 使 worker 重启它的应用。SIGTERM 和 SIGHUP 会立即停止 worker,并中断它的当前请求。请求超时使用 SIGTERM。直接向 worker 发送信号会绕过 master 监管。
在终端中按 Ctrl-C 会向 master 和所有 worker 发送 SIGINT。然后每个 worker 还会收到 master 发送的 SIGQUIT。第二个停止信号使 worker 立即以退出码 131 退出,因此它的当前请求不会完成。要让当前请求完成,只向 master 发送 SIGTERM。
停止
收到停止信号后,master 立即向每个 worker 发送 SIGQUIT。worker 停止接受新连接,并完成当前请求。每个 worker 保留它持有的连接。它用 Connection: close 回答每个连接上的下一个请求,然后该连接关闭。经过 supervisor.process_control_timeout_secs 后,master 向剩余的 worker 发送 SIGTERM。默认限制为 30 秒。如果仍有 worker,master 在 SIGTERM 一秒后发送 SIGKILL。
计算连接排空时间时,先取五秒和控制超时一半中的较小值,再从控制超时中减去该值。使用默认设置时,连接有 25 秒来完成。超过此时间的响应可能被截断。在整个时间限制内保持空闲的连接会在时间限制结束时关闭。
第二个 SIGTERM 或 SIGINT 会跳过等待,立即强制退出。master 的退出码见退出码。
重载会重启应用
SIGUSR2 或 SIGHUP 会重启每个进程池中每个 worker 的应用。worker 结束应用的 PHP 请求,并在同一进程中再次运行入口脚本。在脚本运行之前,worker 解析入口脚本路径中的符号链接,并将其工作目录更改为脚本所在的目录。监听套接字、连接和排队的请求保持不变。旧应用处理信号之前已在队列中等待的请求。之后的请求交给新应用。
在 Classic 模式下,每个请求都在新的 PHP 请求中运行入口脚本。因此,更改的文件无需重载即可生效,opcache.validate_timestamps = 0 时除外。切换入口脚本路径中符号链接的部署在所有模式下都需要重载,包括 Classic 模式。Worker 和 Dispatcher 模式将应用保留在内存中。在这些模式下,每次部署后都要重载进程池。更多内容见部署。
重载会清空 OPcache,因此在 opcache.validate_timestamps = 0 时应用也会加载新代码。opcache_get_status() 的 manual_restarts 值会统计这些重载。重载后,最初的请求会重新编译其 PHP 文件。在重载时处于活动状态的最长请求结束之前,请求在没有 OPcache 的情况下运行。在 Classic 模式下,在 worker 收到重载之后开始的请求运行新代码,活动的请求以旧代码结束。
每个 worker 各自重启它的应用。在启用 OPcache 的 Worker 和 Dispatcher 模式下,大多数 worker 在一次重载期间会启动应用两次。因此,worker 循环之前的代码会运行两次。所有 worker 同时重启时,每个队列只等待它自己的 worker 的应用启动。除了这次等待,客户端不会察觉重启。
master 在停止期间忽略重载信号。它不会记录被忽略的信号。
重载会重启应用,但不会替换进程。worker 保留相同的已初始化引擎。要应用对二进制文件或 master 读取的文件(例如 rapira.toml 和 php.ini)的更改,请重启 Rapira。更改 opcache.preload 加载的文件后,也请重启 Rapira。
当应用代码调用 opcache_reset() 或缓存已满时,OPcache 会安排一次重启。Rapira 随后重载每个进程池,并记录一条警告。没有 worker 进程停止,也没有连接关闭。在 Rapira 下,opcache.force_restart_timeout 的默认值为 0,php.ini 中的值会替换它。如果值大于 0,在 OPcache 重启期间(包括重载期间),OPcache 可能强制终止请求运行时间超过此值的 worker。请保持值为 0。
将状态写入日志
SIGUSR1 使 master 将每个进程池的状态写入日志。进程池的第一行显示运行中和空闲的 worker 数量。然后每个 worker 槽位一行,显示进程标识符、状态和三个计数器:
status: http pool: 4 running, 3 idle
slot 0 pid 4242 state 2 handled 1500 errors 2 recycles 0| 状态 | 含义 |
|---|---|
1 | 启动中。应用尚未启动,或者上一次启动失败。 |
2 | 空闲。worker 等待工作。 |
3 | 活动。worker 正在处理请求。 |
4 | 排空。worker 完成它的工作,然后退出。 |
master 替换槽位中的 worker 时,槽位保留它的计数器。recycles 统计 worker 内部应用的重启次数,例如在 max_requests 或重载之后。
状态输出使用 master 目标上的 info 级别。默认日志级别为 error。将此目标设为 info 以显示输出:
[log.targets]
master = "info"同一目标还包含 worker 创建错误和请求超时警告。更多内容见日志。
Rapira 使用透明大页吗?
不使用。在 Linux 上,master 在 PHP 启动前为它自己的进程关闭透明大页。worker 以及 PHP 用 proc_open() 或 exec() 启动的进程都继承此设置。因此,USE_ZEND_ALLOC_HUGE_PAGES=1 和 opcache.huge_code_pages 得不到透明大页。这些选项仍然可以使用主机通过 vm.nr_hugepages 预留的显式大页。没有设置可以改变此行为。
master 可以在容器中作为 PID 1 运行吗?
可以。作为 PID 1,master 处理停止信号,并回收所有已退出的子进程。你不需要单独的 init 进程。