技术文章

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

Nginx 与 PHP-FPM 性能调优:先定位排队点,再调进程与连接

一句话回答

Nginx 与 PHP-FPM 调优没有通用最优值:先用 stub_status、FPM status 与访问日志分清请求是在 Nginx 排队、在 FPM 进程池等待,还是卡在 PHP 或下游依赖,再按 Little 定律估算并发并核对单进程内存,最后处理上游连接复用、缓冲与 OPcache 的部署取舍。文中配置均为未执行的占位示例。

核心要点 TL;DR
  • 先取基线:FPM 的 max children reached 与 listen queue 比任何参数推荐都更能说明进
  • pm.max_children 由目标并发与单进程实测内存共同决定,不能脱离压测直接抄数值。
  • Nginx 侧的上游 keepalive 与缓冲区会影响 PHP 进程被占用的时长,但其可用性需按实际版本核实。

Nginx 与 PHP-FPM 的调优,难点不在记住几个参数,而在判断请求卡在哪一层。同一个“慢”,可能是在 Nginx 的 worker 排队、在 FPM 进程池里等空闲进程,也可能 PHP 本身在等数据库或外部接口。本文只讨论前两层的定位方法与可调整项;具体数值没有通用答案,需要在你自己的环境里压测确认。

一、先取基线,再改配置#

调参前先让三处数据可见:

  • Nginx:开启 stub_status,观察 active、reading、writing、waiting。waiting 高通常说明连接在等上游,而不是 Nginx 自己忙。
  • PHP-FPM:通过 status 页观察 active processes、idle processes、listen queue,以及 max children reached 计数。后者持续增长,说明进程池已饱和;listen queue 上升,说明连接到达速度超过处理速度。
  • 访问日志:记录 $request_time 与 $upstream_response_time,两者的差值大致反映 Nginx 侧等待,差值之外的耗时则指向 PHP 或其依赖。

状态页可能暴露内部信息,只应允许本机或内网访问;具体开放方式按你的部署拓扑核定。

二、进程池:用并发量倒推,而不是抄数字#

可用处理并发 ≈ 目标 QPS × 平均处理时间(Little 定律的常见用法)。若目标 200 QPS、平均处理 50 ms,则稳态下同时被占用的进程约 10 个;再为突发留余量。

pm.max_children 的上限受内存约束:单进程常驻内存需实测(如 pmap 或 RSS 观察),乘以进程数后,要给系统、Nginx 与其他服务留出空间。没有实测值就设上限,容易把机器压进 swap,反而更慢。

  • pm = static:进程常驻,省去 fork 抖动,适合流量稳定且内存充裕的场景。
  • pm = dynamic:按空闲进程调节,适合波动流量;pm.max_spare_servers 设得过低会让新请求等 fork。
  • pm = ondemand:空闲即退出,适合长期低流量,代价是冷启动延迟。
  • pm.max_requests:用于回收第三方库造成的内存增长;设得过小会增加 fork 频率,属于取舍。
; 未执行的示例,数值为占位,需按实测并发与单进程内存核实
pm = dynamic
pm.max_children = 50
pm.start_servers = 10
pm.min_spare_servers = 10
pm.max_spare_servers = 20
pm.max_requests = 1000

Nginx 侧对应的是 worker_processes auto 与 worker_connections。作为反向代理时,一个客户端连接通常同时占用客户端与上游两个文件描述符,因此 worker_connections 的有效值还受 ulimit -n 限制,需按实际系统配置核对。

三、连接复用与缓冲:缩短 PHP 进程被占用的时间#

FastCGI 上游默认每次请求新建连接,连接复用能减少握手开销;缓冲则让 Nginx 先把后端响应读完,避免慢客户端长时间占住 PHP 进程。两者都与版本和编译选项有关,启用前应核实所用 Nginx 与 PHP-FPM 版本的行为。

# 未执行的示例,参数为占位值
upstream php_fpm {
    server 127.0.0.1:9000;
    keepalive 32;
}
server {
    location ~ \.php$ {
        fastcgi_pass php_fpm;
        fastcgi_keep_conn on;
        fastcgi_buffers 16 16k;
        fastcgi_read_timeout 30s;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

fastcgi_read_timeout 应按“最慢仍可接受”的请求设定,而不是随手放大;设得过长会让卡住的请求长期占用进程。

四、OPcache 与部署流程的取舍#

OPcache 缓存编译后的脚本,减少重复解析。关键取舍在 opcache.validate_timestamps:开启时每个请求会检查文件时间戳,便于直接更新代码;关闭后省去这部分检查,但发布新代码必须重载 PHP-FPM 或显式清理缓存,否则会继续执行旧字节码。opcache.memory_consumption 与 max_accelerated_files 是否够用,可在状态输出中观察命中与耗尽情况,再决定是否调整。

五、边界与常见误区#

  • 盲目加大 pm.max_children 不会提升吞吐,只会把排队从 FPM 转移到内存和 CPU 调度上。
  • 如果基线显示 PHP 处理时间本身就长,调 Nginx 与 FPM 参数收效有限,应先查数据库查询、外部接口与锁竞争。
  • 任何参数改动都应配合压测与回归对比,单次观测不足以支撑结论。

本文未在本环境执行任何命令或压测,示例配置均为占位,数值与可用性需在目标环境中核实。

作者:沐小悠

本文约 6 分钟读完 · 关键词:Nginx 调优、PHP-FPM 调优、pm.max_children、worker_connections、OPcache

更多文章 GET 示例接口

「」标签下的其他文章