技术文章

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

Nginx 与 PHP-FPM 调优:没有测量基线,就没有“实战”

一句话回答

Nginx 与 PHP-FPM 调优应以可复现的测量基线为前提:先把请求拆成客户端到 Nginx、Nginx 到 FPM、PHP 执行、外部依赖四段,再识别连接数、内存、超时三条耦合链,最后用单变量改动加回归判断有效性。文中参数值均为占位,需按版本与本机压测确认。

核心要点 TL;DR
  • 调优的顺序是先建立基线,再做单变量改动,最后做回归验证,而不是先抄一组参数。
  • pm.max_children 受内存预算约束,超出后进程被换出或被杀,比慢更糟。
  • Nginx 与 PHP 两侧的超时值必须成链对齐,否则 502 与 504 的归因会出错。

先说结论:在没有真实负载、也没有可复现的测量基线之前,Nginx 与 PHP-FPM 的“调优实战”只能给方法,不能给数字。本文给出一条可执行顺序——先定义测什么,再看参数如何相互约束,最后用回归判断改动是否真的有效。文中的配置片段是占位示例,未在任何环境执行;具体默认值、取值范围与字段名,需以所装版本的官方文档和本机压测为准(本次未联网核验)。

一、把一次请求拆成可测量的几段#

调优第一步不是改配置,而是定位时间消耗在哪里。一个典型的 PHP 请求可切成四段:客户端到 Nginx、Nginx 到 PHP-FPM 的 FastCGI(FastCGI 是 Nginx 与 PHP 进程管理器之间的通信协议)转发、PHP 进程内的执行、以及 PHP 之外的依赖(数据库、缓存、第三方 API)。四段耗时量级不同,优化方向也完全不同。

可用的观测点包括:Nginx 访问日志中的请求总耗时与上游耗时字段;PHP-FPM 的状态页与慢请求日志;应用侧的采样或 APM。这些字段的名称和开启方式随版本与发行版打包配置而变化,必须在目标机器上确认,不能照抄别处的配置。

二、参数是成组的,不是单点的#

参数它实际控制什么与谁耦合怎么验证
worker_processes / worker_connectionsNginx 侧的并发连接上限与到上游的 keepalive 连接池、文件描述符上限耦合观察连接排队与拒绝计数
pm / pm.max_childrenPHP-FPM 可同时处理的请求数与单进程常驻内存、机器内存总量强耦合内存峰值与进程被杀的记录
pm.max_requests进程回收节奏与内存泄漏型代码、冷启动成本耦合进程重启频率与首请求延迟
各类 timeout失败判定边界Nginx、PHP、FPM 三处必须成链构造慢请求,看错误码落在哪一层

三条容易断的链

  • 内存链:并发进程数乘以单进程常驻内存,就是最坏情况下的内存需求。超过物理内存后,系统会开始换页,延迟上升并且更难诊断,这比“慢”更糟。
  • 连接链:Nginx 到上游是否复用长连接,会直接改变 FPM 侧的连接建立开销与端口占用。
  • 超时链:Nginx 等待上游的时间、PHP 的最大执行时间、FPM 的请求终止时间,三者顺序错位时,同一个故障会表现为 502 或 504 中的不同结果,排查方向也会被带偏。建议让内层先超时,外层留出余量。

三、一个可复现的最小验证流程#

  1. 固定变量:同一份负载脚本、同一并发、同一数据集,记录基线。
  2. 记录分布而非平均值:至少包含 p50、p95、错误率和内存峰值。
  3. 一次只改一个参数组,其余保持不动。
  4. 重复多轮,确认差异超出噪声范围再下结论。
  5. 预先写下回滚条件,改动后不达标就回退,不做连续叠加。

四、占位配置示例(未执行)#

以下仅为结构示意,所有数值都是占位值,不能直接用于生产。

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

server {
    location ~ \.php$ {
        fastcgi_pass php_fpm;
        include fastcgi_params;
        fastcgi_read_timeout 30s; # 占位值,需与 PHP 侧超时对齐
    }
}
; 占位示例:未执行
[www]
pm = dynamic
pm.max_children = 20              ; 占位值,按 内存预算 ÷ 单进程常驻内存 估算
pm.start_servers = 4
pm.max_requests = 500             ; 占位值
request_terminate_timeout = 30s

五、常见误判#

  • 只看平均耗时。长尾请求往往才是用户感知到的部分。
  • 把进程数拉到最大。并发能力受内存约束,超过上限后错误率上升,而不是吞吐上升。
  • 把下游超时算在 PHP 头上。若请求内同步调用外部 API,瓶颈常在网络与对端,不在 FPM。
  • 没有留出观测窗口就上线。缺少改动前后的同口径数据,后续只能靠猜。

六、当下游是 API 时#

PHP 应用若在请求内同步调用第三方 API,调优的重点会从 FPM 参数转向超时设计与错误分类:区分连接失败、超时、对端返回错误和服务端异常,并给每类错误单独的超时与重试策略。否则 FPM 侧再怎么扩容,也只是把等待时间复制到更多进程上。

一句话收尾:先有基线,再谈参数;先定位哪一段慢,再决定动哪个旋钮。

常见问题(FAQ)

pm.max_children 到底设多少合适?
它由可用内存除以单进程常驻内存决定上限,而不是由并发愿望决定。先测单进程内存占用与峰值,再反推上限;具体数字必须在目标机器上压测确认。
改完 FPM 参数后 502 变多怎么办?
先判断是进程耗尽、超时链错位还是上游连接配置问题,再决定是否回调。在没有基线的情况下继续加并发,通常只会把问题从慢变成不可用。

作者:沐小悠

本文约 5 分钟读完 · 关键词:Nginx 调优、PHP-FPM、FastCGI、pm.max_children、性能基线

更多文章 GET 示例接口

「」标签下的其他文章