Nginx 与 PHP-FPM 性能调优:先把请求耗时拆开,再改参数
Nginx 与 PHP-FPM 调优的起点是把单次请求耗时拆到 Nginx 转发、FPM 排队、PHP 执行等环节,确认主导环节后再改对应参数。文中给出可观测项、进程池参数取舍、超时参数对齐关系和一个未执行的配置示意,不提供实测数据;具体版本默认值与压测数字待核实。
把 Nginx 与 PHP-FPM 的组合调快,靠的不是照搬一套“推荐参数”,而是先把单个请求的耗时拆成几段:请求在 Nginx 里等待、转发给 FPM、在进程池里排队、PHP 执行(含数据库与外部调用)、结果回写。哪一段占主导,才动哪一段的参数。本文只讲这个分层方法和参数之间的约束关系;本次没有可用测试记录,因此不给出任何性能数字,也不标注“实测”。
第一步:建立分段耗时视图#
Nginx 侧最直接的两个变量是 $request_time(从收到客户端首字节到响应写完)与 $upstream_response_time(Nginx 等待上游,也就是 FPM 的时间)。把两者写入访问日志后,可以做一个粗略判断:
- 两者接近且都大:时间主要花在 FPM/PHP 侧,往进程池与代码方向查。
$request_time明显大于$upstream_response_time:慢在客户端链路、响应体传输或 Nginx 自身处理,不应先动 FPM。
FPM 侧另有两个开关值得先打开:slowlog(配合 request_slowlog_timeout)能记录超时请求的 PHP 调用栈,用来区分“PHP 自己算得慢”和“卡在等下游”;pm.status_path 暴露进程池状态,可观察活跃进程数、空闲进程数与监听队列。这些开关的具体指令名与默认值在不同 FPM 版本上可能有差异,配置前应以所部署版本的官方文档为准(待核实)。
第二步:按瓶颈段选参数#
如果证据指向 FPM 排队,才轮到进程池参数。它们的作用和代价如下表,方向性结论是稳定的,具体数值需要自行压测。
| 参数 | 作用 | 调大的代价 |
|---|---|---|
pm.max_children | 进程池上限,决定可并发处理的 PHP 请求数 | 内存占用线性上升,过量会触发 swap 甚至 OOM |
pm(static / dynamic / ondemand) | 进程创建与回收策略 | dynamic 有回收与新建开销;ondemand 冷启动延迟更明显 |
pm.max_requests | 单个进程处理多少请求后重启,用于缓解第三方库内存泄漏 | 设得过小会频繁重建进程,抵消 opcache 预热收益 |
估算 max_children 的常用方法是:可用于 FPM 的内存 ÷ 单个 PHP 进程的常驻内存(RSS)。RSS 必须在自己环境里观测,不能引用别人的数字。这里给的是估算方法,属于建议而非结论。
监听方式上,Nginx 与 FPM 同机时用 Unix socket 可省去一层 TCP 处理;跨机部署则只能用 TCP,此时 backlog 与连接数上限才成为需要关注的项。两者收益差多少,取决于请求体大小与并发模型,本文不给数字。
超时参数必须对齐,否则日志会误导#
一个常见现象是:Nginx 返回 504,但 FPM 慢日志里什么都没有。原因通常是 Nginx 等待上游的时间短于 FPM 允许的脚本执行时间,请求被 Nginx 提前掐断。三者的关系应当是:fastcgi_read_timeout(Nginx 等上游)不小于 request_terminate_timeout(FPM 强制终止)与 max_execution_time(PHP 自身限制)中较大的那个。这是配置项之间的逻辑约束,与版本无关。
一个配置示意(未执行)#
下面的片段只用于展示参数位置与相互关系,未在任何环境执行,数值均为占位,不可直接用于生产。
# php-fpm pool(占位示例,未执行)
pm = dynamic
pm.max_children = 40 # 需按 RSS 与本机内存自行推算
pm.start_servers = 8
pm.min_spare_servers = 4
pm.max_spare_servers = 12
pm.max_requests = 500
request_terminate_timeout = 30s
request_slowlog_timeout = 5s
slowlog = /var/log/php-fpm/slow.log
pm.status_path = /fpm-status
# nginx(占位示例,未执行)
location ~ \.php$ {
fastcgi_read_timeout 35s; # 应大于 FPM 的终止时间
fastcgi_pass unix:/run/php-fpm.sock;
}
状态页路径必须限制为仅内网可访问,这一点与性能无关但属于安全边界。
什么时候该停止调参#
- 分段数据显示时间花在数据库或外部 API:改 Nginx 和 FPM 参数不会有实质收益。
- 加大
max_children后内存逼近上限:说明瓶颈是单请求的内存占用或下游延迟,而不是并发额度。 - 没有改动前的基线记录:任何参数变化都无法归因,此时应先补日志与监控。
关于具体 Nginx、PHP-FPM 版本的行为差异、默认值以及调优后的吞吐变化,本次材料不足以确认,均需在目标环境以可复现的压测记录自证(待核实)。