萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PhpStorm 整合 Xdebug 完整設定教學

Xdebug 是 PHP 開發除錯的利器,搭配 PhpStorm 可實現斷點、變數檢視、堆疊追蹤等 IDE 級除錯體驗。本文詳細說明從下載、安裝、php.ini 設定到 IDE 與瀏覽器整合的完整流程。

步驟 1:下載對應版本的 Xdebug

  1. 前往 xdebug.org/download
  2. 或使用 Xdebug Wizard:複製 phpinfo() 輸出貼上,自動推薦版本與設定
  3. 下載 .dll (Windows) 或 .so (Linux/macOS)

步驟 2:修改 php.ini 載入擴充

; Windows 範例
[XDEBUG]
zend_extension = "D:/php/ext/php_xdebug.dll"
xdebug.mode = debug
xdebug.start_with_request = yes
xdebug.client_host = 127.0.0.1
xdebug.client_port = 9003
xdebug.idekey = "PHPSTORM"
xdebug.log = "D:/php/logs/xdebug.log"
xdebug.log_level = 7
注意:Xdebug 3 版本參數名稱變更(xdebug.remote_* → xdebug.client_*、xdebug.mode 取代多個舊參數),請依安裝版本調整。

步驟 3:PhpStorm 設定

  1. File → Settings → PHP → Debug
  2. Xdebug 區塊:Debug port = 9003(對應 xdebug.client_port)
  3. Settings → PHP → Servers 新增伺服器:
    • Host: localhost (或你的虛擬主機域名)
    • Port: 80/443
    • Debugger: Xdebug
    • ✅ Use path mappings → 對應專案根目錄到伺服器 Document Root

步驟 4:瀏覽器擴充套件

步驟 5:啟動除錯

  1. PhpStorm 工具列點擊 📞 Start Listening for PHP Debug Connections(電話圖示變綠)
  2. 瀏覽器 Xdebug Helper 點擊 Debug 模式(圖示變綠)
  3. 造訪目標頁面,程式將在斷點處暫停

常見問題排查

現象可能原因解決方式
斷點不生效Path Mapping 錯誤檢查 Servers 設定的路徑對應
連線逾時Port 被佔用/防火牆改用 9003、確認防火牆允許
xdebug.log 顯示 "Could not connect to client"client_host/port 錯誤確認 PhpStorm 監聽中、IP 正確
Docker 環境無法連線容器內 localhost ≠ 宿主機設定 xdebug.client_host=host.docker.internal

進階:僅針對特定請求觸發

在 php.ini 設定 xdebug.start_with_request = trigger,瀏覽器擴充套件或帶入 XDEBUG_SESSION=PHPSTORM 參數時才啟動除錯,避免影響效能。

總結

完成上述設定後,你將擁有專業級的 PHP 除錯環境:斷點、單步執行、變數觀察、呼叫堆疊、評估運算式 一應俱全。建議搭配 xdebug.log 排查連線問題,並依專案需求調整 xdebug.mode(debug/trace/profile)。

copyright © 萬盛學電腦網 all rights reserved