WAMP 環境配置 xdebug + WinCacheGrind 完整圖文教學

在 Windows + Apache + MySQL + PHP (WAMP) 環境下配置 xdebug 進行效能分析，配合 WinCacheGrind 視覺化工具，能快速定位 PHP 程式瓶頸。本文記錄完整安裝與配置步驟（以 WAMP 2.5 / PHP 5.2.5 為例）。

軟體下載

• xdebug：官網下載頁（選擇對應 PHP 版本、TS/Non-TS、VC 編譯器版本的 php_xdebug.dll）。
• WinCacheGrind：SourceForge 專案頁 下載安裝包。

安裝步驟

1. 將 php_xdebug.dll 複製到 PHP 擴展目錄（例：D:\wamp\bin\php\php5.2.5\ext\）。
2. 編輯 php.ini，於末尾加入：

[Xdebug]
zend_extension_ts="D:/wamp/bin/php/php5.2.5/ext/php_xdebug.dll"
; 必須用 zend_extension_ts (Thread Safe) 或 zend_extension (Non-TS)，不可用 extension=

xdebug.auto_trace=On
xdebug.collect_params=On
xdebug.collect_return=On
xdebug.trace_output_dir="D:/wamp/bin/php/debuginfo"
xdebug.profiler_enable=On
xdebug.profiler_output_dir="D:/wamp/bin/php/debuginfo"

3. 建立輸出目錄 D:\wamp\bin\php\debuginfo 並確保 Apache 執行身分可寫入。
4. 重啟 Apache 服務。
5. 安裝 WinCacheGrind（直接執行安裝程式）。

配置項詳解

驗證與分析

1. 瀏覽任一 PHP 頁面（例：https://localhost:8080/demo/index.php）。
2. 開啟 D:\wamp\bin\php\debuginfo\，確認產生 cachegrind.out.xxxx 與 trace.xxxx.xt。
3. 啟動 WinCacheGrind，開啟 cachegrind.out.xxxx。
4. 即可查看：函數呼叫次數、耗時、記憶體使用、檔案載入順序等關鍵指標。

進階技巧：觸發模式避免全量拖累

生產/開發環境建議改為觸發模式：

xdebug.profiler_enable=0
xdebug.profiler_enable_trigger=1
; 只有帶 ?XDEBUG_PROFILE=1 才會產生 profile

常見問題排查

• 無輸出檔案：檢查 profiler_output_dir 權限、PHP 版本對應、zend_extension 路徑正確。
• WinCacheGrind 開啟報錯：確認檔案非空、格式正確；嘗試用 KCacheGrind (Linux) 交叉驗證。
• 效能嚴重下降：關閉 auto_trace、collect_params、collect_return，僅啟用 profiler。

配置完成後，即可針對慢速請求進行精準效能剖析，優化資料庫查詢、迴圈邏輯與函數呼叫結構。