PHP-FPM(PHP FastCGI Process Manager)是 PHP 官方自带的 FastCGI 进程管理器,也是目前 Nginx + PHP 站点最主流的运行方式。很多 PHP 应用在低保真环境下跑得好好的,一上生产就出现响应慢、502 超时、内存飙升的问题,绝大多数都能通过 PHP-FPM 配置与调优解决。本文从进程池模式、核心参数计算、慢日志定位到常见故障排查,系统讲一遍 PHP-FPM 的实战调优思路。
理解 PHP-FPM 的进程池模型
PHP-FPM 采用「主进程 + 多个工作子进程」的架构。master 进程负责管理子进程、监听连接,真正处理 PHP 请求的是 worker 子进程。请求到来后,master 把请求分发给空闲 worker,worker 执行完脚本再回到空闲队列等待下一个请求。这个模型的关键在于:worker 数量决定了并发能力,而每个 worker 占用的内存决定了这台机器能扛多少并发。
进程池(pm)有三种管理模式,选错模式是很多性能问题的根源:
| 模式 | 行为 | 适用场景 |
|---|---|---|
static | 固定数量的 worker,不动态伸缩 | 内存充足、负载稳定的专用服务器 |
dynamic | 按 min/max 动态增减 worker | 负载波动、内存有限的通用场景(默认) |
ondemand | 有请求才 fork worker,空闲后回收 | 低流量站点、内存极度紧张 |
static,省去动态 fork 的开销;中小站点用 dynamic 更省心;ondemand 虽然省内存,但每次冷启动 fork 进程会带来明显延迟,不适合高并发。核心参数怎么算,而不是拍脑袋
真正决定 PHP-FPM 性能的是 www.conf 里的几个参数。以 dynamic 模式为例,配置文件通常位于 /etc/php/8.x/fpm/pool.d/www.conf:
[www]
user = www-data
group = www-data
listen = /run/php/php8.3-fpm.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0660
pm = dynamic
pm.max_children = 50
pm.start_servers = 5
pm.min_spare_servers = 5
pm.max_spare_servers = 15
pm.max_requests = 500
pm.max_children:并发上限与内存的平衡
pm.max_children 是最关键的参数,它决定同时能处理多少个请求。设太小,请求排队、响应变慢;设太大,worker 把内存吃光,触发 OOM Killer 直接杀进程。一个稳妥的计算方法是:
max_children ≈ (可用内存 - 系统预留) / 单个 worker 平均内存
例:8GB 内存,预留 2GB 给系统与 MySQL
单个 PHP worker 常驻内存约 40MB
max_children ≈ (8192 - 2048) / 40 ≈ 153(按经验再打 7 折 ≈ 100)
单个 worker 内存怎么测?用 ps 看 RSS 列即可:ps -o pid,rss,cmd -C php-fpm8.3。注意看的是 RSS(常驻内存),而不是虚拟内存 VSZ。
pm.max_requests:缓解内存泄漏
第三方库或扩展偶尔会有内存泄漏,worker 跑久了内存只增不减。pm.max_requests 让 worker 处理完指定数量的请求后自动重启,回收泄漏的内存。一般设为 500 到 2000,太小会频繁重启增加开销,太大则失去意义。
用慢日志定位真正的瓶颈
配置再科学,也架不住某条 SQL 或某个接口拖慢整体。PHP-FPM 的慢日志(slow log)能记录执行超过阈值的请求及完整的 PHP 调用栈,是定位性能瓶颈的利器:
; 开启慢日志,阈值 2 秒
slowlog = /var/log/php8.3-fpm.slow.log
request_slowlog_timeout = 2s
request_terminate_timeout = 30s
配置后重载 PHP-FPM,慢请求会记录类似下面的调用栈,直接告诉你慢在哪个函数、哪一行:
[20-Nov-2026 08:00:01] [pool www] pid 1234
script_filename = /var/www/html/index.php
[0x00007f] +++ dumped core +++
[0x00007f] curl_exec() /app/Http/Client.php:88
[0x00007f] fetchRemote() /app/Service/Order.php:142
[0x00007f] => /var/www/html/index.php:20
从调用栈能清楚看到是 curl_exec() 调用外部接口卡住了。这类问题靠调 max_children 是治标不治本的,必须回到代码层面给外部请求加超时与熔断。
几个高频故障与排查思路
502 Bad Gateway
Nginx 报 502,说明它连不上 PHP-FPM 或 PHP-FPM 处理失败。按这个顺序排查:先看 PHP-FPM 是否活着(systemctl status php8.3-fpm),再看 socket 或端口是否与 Nginx 的 fastcgi_pass 一致,最后看 /var/log/php8.3-fpm.log 里是否有「server reached pm.max_children setting」——如果有,说明进程数不够,需要调大 max_children。
请求排队、响应忽快忽慢
多半是 dynamic 模式下 worker 数量在低位徘徊,突发流量时来不及扩容。可以调高 pm.start_servers 和 pm.min_spare_servers,让常驻 worker 保持在合理水位;负载稳定的机器干脆改用 static。
内存持续上涨最终 OOM
先用慢日志和 ps 确认是不是内存泄漏,再用 pm.max_requests 兜底。同时检查是否加载了不必要的扩展,每多一个扩展,每个 worker 都会多占一份内存。
调优参数速查
| 参数 | 作用 | 建议 |
|---|---|---|
pm | 进程管理模式 | 高流量选 static,通用选 dynamic |
pm.max_children | 最大 worker 数 | 按可用内存 / 单 worker RSS 计算 |
pm.max_requests | worker 重启阈值 | 500~2000,别设 0 |
request_slowlog_timeout | 慢请求阈值 | 2s 起步,按业务调整 |
request_terminate_timeout | 请求超时强杀 | 略大于最慢接口耗时 |
php-fpm -t 校验语法,再 systemctl reload php8.3-fpm 平滑重载,不要直接 restart 打断在途请求。总结
PHP-FPM 调优的核心是「用合理的 worker 数量匹配内存,用慢日志找到真正的瓶颈」。max_children 按内存算而不是拍脑袋,max_requests 兜底内存泄漏,慢日志负责定位代码层问题。这三点做好,绝大多数 502、超时、内存飙升的问题都能迎刃而解。调优时记得一次只改一个变量、改完观察监控,才能知道每个参数真正的影响。