如何排查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的慢查詢