Windows 環境下整合 Xdebug 完整指南

1. 取得正確的 DLL

瀏覽 Xdebug Wizard，貼上 phpinfo() 輸出的 HTML，即可獲得精確的下載連結（需符合 PHP 版本、VC 編譯器、Thread Safe 與架構）。

2. 安裝步驟

1. 下載 php_xdebug-.dll 至 PHP 擴充目錄（如 D:\php\ext\）。
2. 編輯 php.ini，新增：

zend_extension = "D:\php\ext\php_xdebug-.dll"

3. 進階設定範例

; 基本除錯
xdebug.default_enable = 1
xdebug.show_exception_trace = 1
xdebug.show_local_vars = 1
xdebug.max_nesting_level = 256

; 變數顯示深度
xdebug.var_display_max_depth = 6
xdebug.var_display_max_children = 256
xdebug.var_display_max_data = 1024

; Profiling 效能分析
xdebug.profiler_enable = 1
xdebug.profiler_output_dir = "D:\php\xdebug_profiler"
xdebug.profiler_output_name = "cachegrind.out.%p"

; 遠端除錯
xdebug.remote_enable = 1
xdebug.remote_host = "localhost"
xdebug.remote_port = 9000
xdebug.remote_autostart = 0
xdebug.remote_connect_back = 0
xdebug.idekey = "PHPSTORM"

4. 重要參數說明

5. 常見坑點

• 若已載入 Zend Optimizer/Opcache，必須先註解其 zend_extension 行，否則 Xdebug 無法載入。
• Thread Safe (TS) 與 Non-Thread Safe (NTS) 版本不可混用。
• 修改 php.ini 後必須重啟 Apache / Nginx / PHP-FPM。