Nginx 与 PHP-FPM 调优:先对齐超时与容量,再谈参数
面向开发者的 Nginx 与 PHP-FPM 调优说明:先梳理请求链路与观测手段,再确定进程池容量与 Nginx/PHP-FPM/上游超时的先后顺序,最后讨论缓冲、静态资源与常见误区;具体数值需结合压测与线上指标核实。
Nginx 与 PHP-FPM 调优的关键,是把「进程池能同时处理多少请求」和「一个请求最多允许占用多久」这两件事分开算清,再让超时从上到下逐层收紧。只改 pm.max_children 或只调大 fastcgi_read_timeout,通常只是把故障从 502 换成 504,或把内存耗尽推迟到高峰时段。
本文不提供未经核验的性能数字:具体容量、超时值和内存上限,需要结合你的压测与线上观测确定。以下参数名依据 Nginx 与 PHP 官方文档的通用语义;文中示例未在任何环境执行,仅用于说明配置形态。
先画清请求链路与失败面#
一次动态请求通常经过:客户端 → Nginx(接收连接、解析请求、转发 FastCGI)→ PHP-FPM 主进程 → 某个 worker 子进程 → 应用代码 → 数据库或外部接口。调优前至少要能回答三个问题:
- 慢在哪一层:是排队等 worker、PHP 执行慢,还是 PHP 在等下游。
- 失败长什么样:502 多指向 PHP-FPM 不可用或连接被拒;504 多指向等待超时;499(Nginx 记录)通常表示客户端先断开。
- 资源上限在哪:worker 数量受内存约束,连接数受文件描述符约束。
观测手段上,Nginx 的 stub_status 可提供连接与请求计数,PHP-FPM 的 pm.status_path 可提供进程池状态(活跃、空闲、排队请求等)。两者都需要显式开启,属于「待核实」的部署前提:请按你实际使用的版本查对应官方文档。
进程池容量:由内存倒推,不由 CPU 倒推#
PHP-FPM 的 pm 常用 static、dynamic、ondemand 三种模式。pm.max_children 是硬上限,超过后新请求在监听队列中排队,队列满则连接失败。
常见做法是先测单个 PHP 进程的常驻内存(RSS),再用可用内存除以它:
可用内存 ≈ 总内存 − 系统与其他服务占用 − 安全余量
pm.max_children ≈ 可用内存 ÷ 单进程 RSS
这不是精确公式:RSS 会随框架、扩展和请求内容波动,且存在共享内存部分。安全余量的取值需要你根据实际波动幅度判断。
dynamic 模式下还有 pm.start_servers、pm.min_spare_servers、pm.max_spare_servers,以及 pm.max_requests(子进程处理若干请求后重启,用于缓解第三方库内存泄漏)。ondemand 适合低流量场景,会牺牲首请求延迟。
容量问题不要用调大超时来掩盖:排队变长时,请求占用 worker 的时间也随之变长,可能形成正反馈。
超时要有先后顺序#
链路上至少存在四层时间限制,若顺序混乱,日志会指向错误的层:
| 层 | 典型配置 | 作用 |
|---|---|---|
| 应用内部 | 框架或代码中的超时 | 限制下游调用,最先触发 |
| PHP 执行 | max_execution_time | 限制脚本自身执行时间;注意 CLI 与外部调用语义不同 |
| PHP-FPM | request_terminate_timeout | FPM 侧强制终止,独立于 PHP 配置 |
| Nginx | fastcgi_read_timeout、fastcgi_connect_timeout、fastcgi_send_timeout | Nginx 等待 FPM 的时限 |
合理的方向是:下游超时 < 应用超时 < FPM 终止时间 ≲ Nginx 读超时。这样超时发生时,你能从日志判断是哪一层先放弃。若 Nginx 先超时而后端仍在跑,客户端收到 504,但 worker 仍被占用,属于典型的无效消耗。
# 示例:仅示意配置形态,未执行
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php/php-fpm.sock;
fastcgi_read_timeout 30s;
}
套接字路径、超时数值都需按你的实际部署替换;unix 套接字与 TCP 监听在延迟与可观测性上也有差别,需要按环境评估。
缓冲与静态资源#
fastcgi_buffers、fastcgi_buffer_size、fastcgi_busy_buffers_size 控制 Nginx 如何缓存上游响应。响应头过大或页面较大、缓冲区不足时,Nginx 可能写临时文件,带来磁盘 IO。是否调整应以实际响应大小为据,而非照抄数值。
静态文件交由 Nginx 直接返回(try_files、expires、gzip 等),可减少进入 FPM 的请求量。这是结构性优化,收益通常比微调参数更稳定。
验证方式与边界#
- 先建立基线:记录正常时段的排队数、活跃进程数、502/504 比例、单请求耗时分布。
- 只改一个变量,在可比流量下观察,避免同时调整容量与超时。
- 检查配置语法并平滑重载,确认生效后再看指标。
本文未附带压测结果,也不承诺任何参数组合的收益。版本相关的默认值与行为差异,请以你部署版本对应的 Nginx 与 PHP 官方文档为准;在没有可用的一手材料时,相关细节标记为待核实,而不是给出确定结论。