PHP 應用效能優化系列（二）：用 Xdebug 分析效能瓶頸

為什麼需要分析器

操作碼快取解決編譯開銷，但無法揭示執行期瓶頸：慢 SQL、低效演算法、記憶體洩漏、過度物件建立。分析器能量測每個函數呼叫次數、耗時、記憶體，精準定位熱點。

Xdebug 簡介

• 開源、支援 PHP 7.1+ / 8.x
• 功能：分析、除錯 (DBGp)、程式碼覆蓋率、追蹤
• 輸出格式：CacheGrind 相容，可用 KCacheGrind、QCacheGrind、PhpStorm、VS Code 視覺化

安裝與啟用

# Linux (PECL)
pecl install xdebug

# 或編譯安裝
wget https://xdebug.org/files/xdebug-3.2.0.tgz
tar xzf xdebug-3.2.0.tgz
cd xdebug-3.2.0
phpize
./configure --enable-xdebug
make && sudo make install

php.ini 設定（僅開發/測試環境啟用）：

zend_extension=xdebug.so
xdebug.mode=profile,develop
xdebug.output_dir=/tmp/xdebug_profiler
xdebug.start_with_request=trigger
xdebug.trigger_value=XDEBUG_PROFILE
# 瀏覽器安裝 Xdebug Helper 擴充，點擊即可觸發分析

分析輸出檔案

1. 瀏覽器觸發分析後，/tmp/xdebug_profiler 產生 cachegrind.out.xxx
2. 用 KCacheGrind (Linux)、QCacheGrind (跨平台)、PhpStorm 開啟
3. 關鍵視圖：
   • Flat Profile：依自耗時排序，找最耗時函數
   • Call Graph：呼叫關係圖，追蹤熱點路徑
   • Caller Map：誰呼叫了慢函數

常見瓶頸模式與對策

生產環境替代方案

Xdebug 會顯著降低效能（約 2-10x），嚴禁生產環境常駐啟用。生產環境可用：

• Blackfire.io：低開銷、SaaS、CI/CD 整合
• Tideways：PHP 專用、時間序列、異常偵測
• DataDog / New Relic APM：全棧監控
• Swoole Tracker：Swoole 環境專用

除錯技巧：斷點調試

Xdebug 3 + PhpStorm/VS Code：

1. IDE 設定 PHP CLI 解釋器 + Xdebug
2. 啟動 Listen for Debug Connections
3. 瀏覽器觸發 XDEBUG_SESSION Cookie
4. 程式碼打斷點，即時檢查變數、堆疊、逐步執行