通过配置
php
-fpm 的慢日志（slowlog），可自动捕获并记录执行超时的请求堆栈，精准定位 `sleep()`、数据库阻塞、未优化循环等隐藏
性能瓶颈
。
在生产环境中，PHP 脚本偶发性卡顿（如页面加载长达数秒）往往难以复现和追踪——尤其是当问题源于一段被遗忘的 sleep(5)、未加超时的 file_get_contents()、或死锁的数据库查询时。手动全局搜索关键词（如 sleep、usleep、time_nanosleep）效率低且易遗漏，而启用 PHP 内置的
慢请求日志（slowlog）
是最直接、可靠且无侵入性的诊断手段。
✅ 启用 PHP-FPM 慢日志的核心配置
在对应 PHP-FPM Pool
配置文件
中（如 /etc/php/8.2/fpm/pool.d/www.conf），添加或修改以下两项：
⚠️ 注意事项： slowlog 文件路径的父目录（如 /var/log/php-fpm/）必须由 www-data（或对应 FPM 用户）可写； 修改后需重启 PHP-FPM：sudo systemctl reload php8.2-fpm（版本号请按实际调整）； 此功能仅对通过 PHP-FPM 处理的 Web 请求生效（不适用于 CLI 模式）。
? 日志示例：一眼识别“罪魁祸首”
当某请求执行超过 3 秒，slow.log 中将生成类似如下堆栈：
该输出清晰显示：请求在 utils.php 第 42 行调用了 sleep()，并逐层回溯至入口文件——无需猜测，直接定位问题代码行。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
立即学习
“
PHP免费学习笔记（深入）
”；
? 进阶建议
渐进式调优
：初始设为 5s，确认无误后再逐步降至 2s 或 1s，避免日志爆炸；
结合其他工具
：慢日志定位“哪里慢”，再配合 Xdebug（开发环境）或 Blackfire（生产）深入分析函数耗时；
警惕隐式阻塞
：除 sleep() 外，还需关注
stream
_socket_client()（无超时）、
curl
_exec()、
mysql
i_query() 等可能长期挂起的操作。
启用 slowlog 是 PHP 性能可观测性的基石能力——它不修改业务代码、不增加运行开销（仅超时时记录），却能在问题发生时提供决定性线索。与其在千行代码中“盲搜” sleep，不如让 PHP-FPM 主动为你标记出每一处拖慢用户体验的阻塞点。
; 指定慢日志文件路径（确保目录存在且 PHP-FPM 进程有写入权限）
slowlog = /var/log/php-fpm/slow.log
; 触发慢日志记录的执行阈值（建议从 3s 开始，按需调低）
request_slowlog_timeout = 3s[12-Oct-2024 14:22:36] [pool www] pid 12345
script_filename = /srv/www/example.com/public/index.php
[0x00007f8b1c0a1234] sleep() /srv/www/example.com/lib/utils.php:42
[0x00007f8b1c0a1256] process_data() /srv/www/example.com/app/controller.php:88
[0x00007f8b1c0a1278] handle_request() /srv/www/example.com/public/index.php:25