環境假設
- Ubuntu Server,已安裝 Apache2 + PHP5(或 PHP7)。
- 需 root/sudo 權限。
方式一:原始碼編譯安裝(通用、可控版本)
- 下載原始碼:
wget https://xdebug.org/files/xdebug-2.2.1.tgz(換成最新版)
- 解壓並進入目錄:
tar -zxvf xdebug-2.2.1.tgz && cd xdebug-2.2.1
- 安裝 PHP 開發頭文件:
apt-get install php5-dev(PHP7 用 php-dev)
- 生成 configure:
phpize
- 配置並編譯:
./configure --enable-xdebug
make && make install
- 編輯
php.ini(CLI 與 Apache 可能不同,需同時修改):
zend_extension=/usr/lib/php5/20100525/xdebug.so # 路徑以 make install 輸出為準
xdebug.profiler_enable=1
xdebug.trace_output_dir="/tmp/xdebug"
xdebug.profiler_output_dir="/tmp/xdebug"
- 重啟 Apache:
service apache2 restart
- 驗證:
php -m | grep xdebug 或瀏覽 phpinfo() 頁面。
方式二:apt-get 直接安裝(快速、自動依賴)
apt-get install php5-dev php5-cli php5-xsl
pecl install xdebug
# 若 pecl 失敗,通常缺 perl:apt-get install perl 後重試
# 自動生成的 ini 通常在 /etc/php5/conf.d/20-xdebug.ini
# 確認 zend_extension 路徑正確,重啟 Apache
Vim 除錯外掛(可選)
apt-get install vim
cd ~
wget https://www.greatmoo.com/xdebug-plugin.tar.gz
tar zxvf xdebug-plugin.tar.gz
mkdir -p .vim
mv plugin .vim/
# Vim 中 F5 啟動偵聽,瀏覽器帶參數 XDEBUG_SESSION_START=1 即可斷點除錯
常用 Xdebug 設定速查
| 設定 | 說明 | 建議值 |
| xdebug.remote_enable | 啟用遠端除錯 | 1 |
| xdebug.remote_host | IDE 所在 IP | 127.0.0.1 或宿主機 IP |
| xdebug.remote_port | 除錯埠 | 9000 |
| xdebug.remote_autostart | 每請求自動連接 IDE | 1 (開發環境) |
| xdebug.profiler_enable | 效能分析 | 1 (按需開啟) |
| xdebug.var_display_max_depth | 變數顯示深度 | 5 |
關閉 Xdebug(生產環境必須)
# php.ini
xdebug.default_enable = 0
# 或單一腳本中
xdebug_disable();
故障排查
make 報錯 → 檢查 phpize 版本是否與 PHP 版本匹配。
- 模組載入失敗 →
php -v 看警告,確認 zend_extension 路徑、架構 (32/64bit) 一致。
- 除錯不中斷 → 檢查
xdebug.remote_connect_back、防火牆埠 9000、IDE 監聽設定。