技术文章

外部链接将在新标签页打开。

Nginx 与 PHP-FPM 调优:进程池容量、FastCGI 交接面与超时分层

一句话回答

本文说明 Nginx 与 PHP-FPM 调优的判断顺序:先依据 upstream 耗时、listen queue 与 worker 状态判断排队发生在哪一侧,再处理进程池容量与 FastCGI 交接面参数。进程池大小由可用内存与单 worker 常驻内存的比值决定,需要本机测量;超时限制应按层设置,外层应大于内层。文中不含实测数据,配置片段均为未执行的占位示例。

Nginx 与 PHP-FPM 的调优没有一组可以通用的参数值:同一份配置在不同内存规格、不同扩展组合和不同请求画像下,结论会相反。本次写作没有可引用的官方文档、版本说明或基准测试数据,因此下面不给“把 pm.max_children 调到多少”这类数字,而是给出一条可复现的判断顺序:先确认时间花在哪一侧,再改两者之间的交接面,最后用同一口径复测。文中所有配置片段都是占位示例,未实际执行,也不代表推荐值。

为什么必须把两者分开看#

Nginx 是事件驱动的服务,PHP-FPM 是由 master 派生出若干 worker 的常驻进程池。一个动态请求的路径是:Nginx 接受连接,经 FastCGI 协议转交 FPM,某个 worker 执行 PHP,结果再回传给客户端。两端的容量约束不同:Nginx 的并发能力通常不是最先出现的瓶颈,而 FPM 侧同时受 worker 数量与单请求耗时约束。在资源有限的系统里,可用一个近似关系来规划:并发请求数 ≈ 吞吐 × 平均请求耗时。这意味着只增加 worker 而不改变单请求耗时,吞吐不会按比例上升,只是把排队的位置从队列挪到了 CPU 和内存上。

先判断排队发生在哪一段#

  • Nginx 侧的时间差:比较请求总耗时与转发到 upstream 的耗时。两者接近,说明时间花在 FPM;总耗时明显更大,说明还有 Nginx 自身或客户端侧的发送、缓冲开销。变量名与语义随版本变化,需按所部署版本的官方文档核对。
  • FPM 侧的队列:status 页面能看到等待被 accept 的连接数与活跃/空闲 worker 数。队列长期不为零,说明 worker 不足或单请求过慢,两种情况要分开处理。status 页需要在 pool 配置中显式开启,字段名按版本核实。
  • 慢请求栈:慢日志能在请求超过阈值时记录调用栈,定位卡在哪一行;开启本身有开销,是否启用按环境决定。

判断阶段一次只改一处。同时调整进程池、缓冲区和超时,事后无法归因。

进程池:参数之间是算术关系#

pm.max_children 的上限来自可用内存除以单个 worker 的常驻内存。单 worker 的内存占用取决于加载的扩展、框架代码量和请求峰值,只能在目标机器上测量,本文不提供数值。进程管理方式有三种取舍:

  • static:固定进程数,延迟稳定,内存常驻不释放。
  • dynamic:在最小与最大空闲进程之间伸缩,需要同时设定起始进程数。
  • ondemand:空闲即退出,省内存,代价是冷启动延迟。

pm.max_requests 用于定期回收 worker,缓解可能存在的内存增长,代价是重建进程的切换成本。

; 占位示例,未执行,非推荐值
[www]
pm = dynamic
pm.max_children = <可用内存 / 单 worker 常驻内存>
pm.start_servers = <待按测量结果确定>
pm.min_spare_servers = <待定>
pm.max_spare_servers = <待定>
pm.max_requests = <待定>
request_terminate_timeout = <按业务最长执行时间设定>
slowlog = /path/to/slow.log
request_slowlog_timeout = <待定>

交接面:连接方式、缓冲区与连接复用#

Unix socket 与 TCP:socket 少一层网络栈,但受文件权限和 backlog 影响;TCP 便于跨机与容器网络。哪个更快必须以本机压测为准,这里不给结论。

缓冲区:缓冲区容量决定响应头和响应体是留在内存还是落到临时文件。响应体超过缓冲区且允许临时文件时,Nginx 会写盘,慢盘上会直接抬高延迟。

连接复用:默认情况下,每次请求结束后 FastCGI 连接都会关闭。要让 Nginx 复用与 upstream 的连接,需在 upstream 块中配置 keepalive,并配合 FastCGI 侧的连接保持设置,具体指令与默认值随版本不同,需按官方文档核实。

# 占位示例,未执行,非推荐值
upstream php_fpm {
    server unix:/run/php-fpm.sock;
}

location ~ \.php$ {
    fastcgi_pass php_fpm;
    fastcgi_read_timeout  <应大于 PHP 侧执行上限>;
    fastcgi_buffers 16 16k;
    fastcgi_busy_buffers_size 32k;
}

超时要分层,不能只设一层#

至少有三层限制在起作用:Nginx 等待 upstream 读取的超时、PHP 的脚本执行上限、FPM 对单个请求的终止时限。设计原则是外层大于内层:如果 Nginx 先断开,访问日志里只留下 504,而 PHP 侧真正的错误位置不会出现在 Nginx 日志中,排查方向会被误导。各层的默认值随版本变化,需以所部署版本的官方文档为准。

复测方式与边界#

复测时保持单变量、同口径:同一并发、同一数据集、同一预热状态,记录分位数而不只看平均值,并把压测方法写进记录,便于他人重复。本文没有运行任何压测,不提供性能数字。另外要提醒一点:OPcache 配置、数据库与外部接口调用、同步写日志,对响应时间的影响常常大于进程池微调,先把这些排除,再动参数。

版本、默认值与具体取值均需结合部署环境核实;本文提供的是判断顺序,不是可直接套用的配置。

作者:沐小悠

本文约 6 分钟读完 · 关键词:Nginx、PHP-FPM、FastCGI、性能调优、进程池

更多文章 GET 示例接口

「」标签下的其他文章