技术文章

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

Nginx 与 PHP-FPM 调优:先定位请求卡在哪一段,再改参数

一句话回答

没有版本、负载与观测数据时,Nginx 与 PHP-FPM 调优应先按请求链路分段定位瓶颈,再改对应配置;进程池容量需按单进程内存占用推算并留余量,Nginx 与 PHP 侧的超时是不同语义的开关,需对齐而非统一取值。文中配置仅为结构示意,未执行。

缺少具体版本、业务负载和观测数据时,Nginx 与 PHP-FPM 的“性能调优”能提供的不是一份推荐参数清单,而是一条排查顺序:先确认请求卡在哪一段,再改那一段的配置项。下面只讨论链路职责与配置语义的边界;涉及默认值、阈值和版本差异的部分,需以实际部署版本的官方文档和本地观测为准。

把一次 PHP 请求拆成四段#

从客户端到脚本返回,请求依次经过:Nginx worker 接收并转发、FastCGI 连接建立与排队、PHP-FPM 进程池分配 worker、应用内部耗时(数据库、外部接口、文件 IO)。调参之所以常无效,是因为改动落在与瓶颈无关的那一段。

Nginx 日志中的 $request_time 与 $upstream_response_time 可以粗略区分“客户端慢”和“上游慢”:前者覆盖整个请求,后者只覆盖转发给 FastCGI 后的等待。前提是你的日志格式里确实配置了这两个变量,这一点需要自行确认。

进程池:pm 模式决定空闲占用,max_children 决定并发上限#

pm 的取值(static、dynamic、ondemand)影响的是空闲时保留多少 worker,而不是系统能扛多少并发;真正的上限由 pm.max_children 和队列行为决定。容量可以用推算而非猜测的方式确定:以单个 PHP 进程的常驻内存峰值为基数,用可分配给 PHP 的内存除以该基数,得出理论上限,再留出余量给系统与其他服务。这是推算方法,不是实测结论,基数必须在自己的进程上取。

需要注意,max_children 设得超过内存承受能力,换来的不是更高吞吐,而是交换与超时。队列长度与拒绝策略也应一并明确,否则溢出会以超时的形式出现在上游。

层主要配置项决定什么
Nginx 连接worker_processes、worker_connections可同时持有的连接规模(总量约为二者乘积,属近似)
FastCGI 转发fastcgi_read_timeout、缓冲区相关指令等待上游的时间与响应体搬运方式
PHP-FPM 进程池pm、pm.max_children并发处理能力与排队行为
应用OPcache 配置、外部依赖单请求的实际耗时

超时:几个开关语义不同,要对齐而不是取同一个值#

fastcgi_read_timeout 是 Nginx 等待 FastCGI 响应的读超时;FPM 侧的 request_terminate_timeout 会终止超时的 worker;PHP 的 max_execution_time 计的是脚本执行时间。三者的计时对象并不完全一致,例如阻塞在外部网络调用上的时间是否计入,需要按版本文档核实。常见故障是 Nginx 先于 FPM 放弃,客户端拿到 504,而 PHP 侧仍在继续跑完——表现为“日志里两边都超时,但时间对不上”。

结构示意(未执行)#

以下片段仅示意指令之间的关系,数值需按实际环境确认,未在本文中运行。

# 未执行的示例:Nginx 转发到 PHP-FPM
location ~ \.php$ {
    include        fastcgi_params;
    fastcgi_pass   unix:/run/php-fpm.sock;
    fastcgi_read_timeout 60s;
}
; 未执行的示例:PHP-FPM 进程池
[www]
pm = dynamic
pm.max_children = <按单进程内存峰值推算后填写>
request_terminate_timeout = 60s

什么时候该停止调参数#

如果观测显示时间主要消耗在数据库查询或外部接口等待上,继续调 Nginx 与 FPM 只能改变排队方式,不能缩短单请求耗时,甚至会把压力推到更靠前的位置。此时更有效的动作在应用层。反之,如果日志显示上游响应很快、但请求整体很慢,问题更可能在连接数与缓冲区,而不是进程池。判断依据应来自自己的日志与监控,而不是通用推荐值。

作者:沐小悠

本文约 5 分钟读完 · 关键词:Nginx、PHP-FPM、FastCGI、进程池、超时配置

更多文章 GET 示例接口

「」标签下的其他文章