技术文章

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

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-FPMrequest_terminate_timeoutFPM 侧强制终止,独立于 PHP 配置
Nginxfastcgi_read_timeout、fastcgi_connect_timeout、fastcgi_send_timeoutNginx 等待 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 的请求量。这是结构性优化,收益通常比微调参数更稳定。

验证方式与边界#

  1. 先建立基线:记录正常时段的排队数、活跃进程数、502/504 比例、单请求耗时分布。
  2. 只改一个变量,在可比流量下观察,避免同时调整容量与超时。
  3. 检查配置语法并平滑重载,确认生效后再看指标。

本文未附带压测结果,也不承诺任何参数组合的收益。版本相关的默认值与行为差异,请以你部署版本对应的 Nginx 与 PHP 官方文档为准;在没有可用的一手材料时,相关细节标记为待核实,而不是给出确定结论。

作者:沐小悠

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

更多文章 GET 示例接口

「」标签下的其他文章