php-fpm 慢日志配置在 www.conf 中,需设置 request_slowlog_timeout(如 3s)和 slowlog(如 /var/log/php-fpm/slow.log),且必须取消分号注释;路径权限与运行用户需匹配,验证需用 sleep 脚本测试并检查日志输出。

PHP-FPM 慢日志在哪配?不是 php.ini,是 www.conf
PHP 8.5 的慢日志功能由 PHP-FPM 管理,和 php.ini 无关;它只对通过 FPM 处理的 Web 请求生效(CLI 脚本完全不记录)。配置项必须写在 FPM Pool 文件里,常见路径是 /etc/php/8.5/fpm/pool.d/www.conf 或 /usr/local/php/etc/php-fpm.d/www.conf(源码安装时)。
关键配置只有两个,缺一不可:
-
request_slowlog_timeout = 3s:设为大于 0 的值才启用,单位支持s、m、h,例如1.5s合法,1500ms不合法 -
slowlog = /var/log/php-fpm/slow.log:路径父目录(如/var/log/php-fpm/)必须存在,且属主为 FPM 运行用户(通常是www-data或nginx),否则日志写入失败但无报错提示
注意:这两行前面的分号 ; 必须删掉,否则等于注释——这是最常被忽略的配置失效原因。
怎么确认慢日志真的在工作?别等线上卡顿才看
改完配置后,不能只靠“等慢请求出现”,得主动验证。先用一个可控的测试脚本触发慢行为:
立即学习“PHP免费学习笔记(深入)”;
<?php sleep(4); echo "done"; ?>
然后执行以下步骤:
- 重启服务:
sudo systemctl reload php8.5-fpm(Ubuntu/Debian)或sudo systemctl reload php-fpm(CentOS/RHEL,注意服务名可能不含版本号) - 访问该脚本一次,确保它执行超时(比如设了
3s就 sleep 4 秒) - 立刻检查日志:
tail -n 20 /var/log/php-fpm/slow.log - 若看到类似
[pool www] pid 12345 script_filename = /path/to/test.php开头的块,并带函数调用栈(如sleep() /path/to/test.php:2),说明已生效
如果日志空或报权限错误,优先检查 ls -ld /var/log/php-fpm/ 和 ps aux | grep php-fpm 看实际运行用户是谁。
慢日志里看到 curl_exec 或 PDO::query 卡住,怎么办?
慢日志不会告诉你“数据库连不上”或“API 域名解析失败”,它只忠实地记录阻塞点。例如:
[0x00007f8b1c0a1234] curl_exec() /srv/app/api.php:42
这表示请求卡在 curl_exec(),但原因可能是:
- 目标服务器无响应(网络问题或对方宕机)
-
curl_setopt($ch, CURLOPT_TIMEOUT, ...)没设或设得太大 - DNS 解析慢(没配
CURLOPT_DNS_CACHE_TIMEOUT或本地 DNS 不稳) - PDO 查询卡住,大概率是没加
PDO::ATTR_TIMEOUT或 SQL 死锁/没索引
此时不能只改慢日志阈值,而要顺藤摸瓜:在对应代码行前后加 microtime(true) 打点,或用 strace -p <pid></pid> 抓系统调用,确认是网络等待、磁盘 I/O 还是内核态阻塞。
为什么设成 1s 后日志爆炸?阈值不是越小越好
设 request_slowlog_timeout = 1s 看似严格,但在高并发场景下,哪怕 5% 的请求因瞬时 IO 或锁竞争多耗 1 秒,每秒 100 个请求就会产生 5 条日志——一天就是 43 万行,磁盘 IO 和日志轮转都会吃紧。
建议渐进式调整:
- 首次上线:从
5s起手,观察 24 小时,确认有无误报 - 确认稳定后:逐步降到
3s→2s,每次至少观察 6 小时 - 生产核心接口可单独建 Pool,配更严阈值(如
request_slowlog_timeout = 800ms),避免干扰全局配置
还有一点容易被忽略:慢日志本身不记录 HTTP 状态码或客户端 IP,如果要关联请求上下文,得配合 Nginx 的 $request_time 和 access_log 一起分析。











