PHP 5.5 + Xdebug + Zend Studio 完整除錯環境搭建教程

Xdebug 是 PHP 最強大的除錯與分析擴展，配合 Zend Studio 可實現斷點、單步執行、變數檢視、堆疊追蹤等 IDE 級除錯體驗。本文記錄 PHP 5.5 環境下的完整安裝配置步驟。

一、安裝 Xdebug 擴展

1. 下載對應版本：訪問 xdebug.org/download.php，根據 php -v 與 php -i | grep "Thread Safety" 輸出選擇正確的 DLL（TS/Non-TS、VC11/VC14、32/64-bit）。
2. 放置檔案：將下載的 DLL 複製到 PHP ext 目錄，重命名為 php_xdebug.dll。
3. 配置 php.ini：在檔案末尾新增：

   [xdebug]
   zend_extension="php_xdebug.dll"
   xdebug.remote_enable = On
   xdebug.remote_host = "localhost"
   xdebug.remote_port = 9000
   xdebug.remote_handler = "dbgp"
   xdebug.auto_trace = 1
   xdebug.collect_includes = 1
   xdebug.collect_params = 1
   xdebug.collect_return = 1
   xdebug.default_enable = 1
   xdebug.collect_assignments = 1
   xdebug.collect_vars = 1
   xdebug.remote_autostart = 0   ; 建議關閉自動啟動，改由瀏覽器插件控制
   xdebug.remote_connect_back = 1
   xdebug.show_local_vars = 1
   xdebug.show_exception_trace = 0

4. 驗證安裝：執行 php -m | grep xdebug 或瀏覽 phpinfo() 頁面，確認出現 Xdebug 區塊。

二、配置 Zend Studio 整合 Xdebug

1. 開啟 Window → Preferences → PHP → Installed Debuggers。
2. 雙擊 Xdebug，彈出設定對話框：
   • Debug Port：9000（與 php.ini 一致）
   • Accept remote session (JIT)：選 localhost（僅本機觸發除錯）或 prompt（每次詢問）
3. 點擊 OK 套用。

JIT 模式說明
• off：關閉瀏覽器觸發除錯
• localhost：僅 localhost 訪問時啟動
• any：任意 IP 訪問皆啟動（生產環境禁用）
• prompt：彈窗詢問是否除錯

三、瀏覽器端控制除錯啟動（推薦）

避免每次請求都進入除錯模式，安裝 Firefox 插件 Easy Xdebug（或 Chrome 的 Xdebug Helper）。

1. 修改 php.ini：xdebug.remote_autostart = 0（關閉自動啟動）。
2. 安裝插件，工具列會出現一隻「小綠蟲」圖示。
3. 點擊圖示啟用（蟲子上出現紅點），此時瀏覽器會攜帶 XDEBUG_SESSION_START Cookie 發送請求，Zend Studio 自動彈出除錯視窗。

四、常見問題排查

五、進階：啟用分析器

xdebug.profiler_enable = 1
xdebug.profiler_output_dir = "/tmp/xdebug_profiler"
xdebug.profiler_output_name = "cachegrind.out.%p"

產出的 cachegrind.out.* 可用 KCacheGrind (Linux) / QCacheGrind (Windows) / Webgrind (Web) 視覺化分析效能瓶頸。

完成上述配置後，即可在 Zend Studio 中享受現代化 PHP 除錯體驗：設定斷點 → 瀏覽器觸發 → 單步執行 → 即時變數檢視 → 呼叫堆疊分析。