如何排查ubuntu上php-fpm的慢查询

1. 启用PHP-FPM慢查询日志

慢查询日志是定位PHP脚本执行慢的关键。需修改PHP-FPM池配置文件（通常位于/etc/php/{version}/fpm/pool.d/www.conf，{version}如7.4、8.1），设置以下参数：

; 开启慢日志并指定路径（确保目录存在且有写入权限）
slowlog = /var/log/php-fpm/www-slow.log
; 设置慢查询阈值（单位：微秒，如1秒=1000000微秒）
request_slowlog_timeout = 1000000
; 记录慢查询的调用堆栈深度（可选，用于更详细的分析）
slowlog_max_stack_trace_lines = 20

修改后重启PHP-FPM使配置生效：

sudo systemctl restart php{version}-fpm

2. 实时查看慢查询日志

使用tail命令实时监控慢日志输出，快速定位当前慢请求：

sudo tail -f /var/log/php-fpm/www-slow.log

日志内容通常包含执行时间、请求URI、调用堆栈（如涉及的函数、文件），例如：

[27-Sep-2025 10:00:00] WARNING: [pool www] child 12345, script '/var/www/html/index.php' (request: "GET /api/orders") execution timed out (1.23456 sec), logging to '/var/log/php-fpm/www-slow.log'
[stack trace]
#0 /var/www/html/index.php(45): PDO->query('SELECT * FROM or...')
#1 /var/www/html/api/orders.php(12): getOrderController->getOrders()

3. 分析慢日志（命令行工具）

使用工具快速提取慢日志中的关键信息，例如：

统计慢请求频率：找出最常出现的慢请求路径或IP。

# 统计每个请求URI的慢查询次数（按次数降序）
grep 'script' /var/log/php-fpm/www-slow.log | awk '{print $6}' | sort | uniq -c | sort -nr | head -10

# 统计每个客户端的慢查询次数（按次数降序）
grep 'REMOTE_ADDR' /var/log/php-fpm/www-slow.log | awk '{print $2}' | sort | uniq -c | sort -nr | head -10

提取慢请求详情：查看具体慢请求的堆栈信息。

# 提取包含特定URI（如/api/orders）的慢日志
grep '/api/orders' /var/log/php-fpm/www-slow.log

4. 关联数据库慢查询日志

PHP慢查询常与数据库操作相关，需同步开启MySQL/MariaDB的慢查询日志，定位慢SQL：

修改MySQL配置（/etc/mysql/mysql.conf.d/mysqld.cnf）：

[mysqld]
slow_query_log = 1
slow_query_log_file = /var/log/mysql/slow-query.log
long_query_time = 1  ; 设置慢SQL阈值为1秒
log_queries_not_using_indexes = 1  ; 记录未使用索引的查询

重启MySQL并分析慢日志：

sudo systemctl restart mysql
# 使用mysqldumpslow分析慢SQL（按执行时间排序）
mysqldumpslow -s t /var/log/mysql/slow-query.log
# 或使用pt-query-digest（需安装Percona Toolkit）
pt-query-digest /var/log/mysql/slow-query.log

5. 使用性能分析工具深入排查

若慢日志无法定位具体瓶颈，可使用以下工具进行深度分析：

Xdebug：生成函数级性能分析报告，查看代码执行时间分布。

# 安装Xdebug
sudo apt install php-xdebug
# 修改php.ini（/etc/php/{version}/fpm/php.ini）
zend_extension=xdebug.so
xdebug.mode=profile
xdebug.output_dir=/tmp/xdebug
# 重启PHP-FPM后，访问页面会在/tmp/xdebug生成分析文件

Blackfire：商业性能分析工具，提供可视化报告（支持函数调用树、内存占用分析）。
Webgrind：轻量级Web界面，解析Xdebug生成的profile文件，展示性能瓶颈。

6. 优化PHP-FPM配置

根据服务器资源调整PHP-FPM进程参数，避免进程过多/过少导致的性能问题：

; 进程管理方式（动态调整更适合大多数场景）
pm = dynamic
; 最大子进程数（根据CPU核心数调整，如4核可设为20）
pm.max_children = 20
; 启动时的子进程数（建议为max_children的1/4）
pm.start_servers = 5
; 最小空闲子进程数（避免频繁创建进程）
pm.min_spare_servers = 5
; 最大空闲子进程数（避免占用过多内存）
pm.max_spare_servers = 10
; 请求完成后终止进程（避免内存泄漏）
pm.max_requests = 500

修改后重启PHP-FPM：

sudo systemctl restart php{version}-fpm

7. 其他优化措施

启用OPcache：缓存编译后的PHP脚本，减少重复解析时间。

; 修改php.ini（/etc/php/{version}/fpm/php.ini）
zend_extension=opcache.so
opcache.enable=1
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=4000

使用缓存：对频繁访问的数据库查询结果使用Redis/Memcached缓存，减少数据库负载。
异步处理：将耗时任务（如发送邮件、生成报表）放入消息队列（如RabbitMQ、Redis），避免阻塞PHP进程。

通过以上步骤，可系统排查Ubuntu上PHP-FPM的慢查询问题，从日志分析到代码优化，逐步定位并解决性能瓶颈。

如何排查ubuntu上php-fpm的慢查询