萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Ubuntu 安裝配置 Xdebug 完整教程:原始碼編譯與 apt-get 兩種方式

環境假設

  • Ubuntu Server,已安裝 Apache2 + PHP5(或 PHP7)。
  • 需 root/sudo 權限。

方式一:原始碼編譯安裝(通用、可控版本)

  1. 下載原始碼:
    wget https://xdebug.org/files/xdebug-2.2.1.tgz(換成最新版)
  2. 解壓並進入目錄:
    tar -zxvf xdebug-2.2.1.tgz && cd xdebug-2.2.1
  3. 安裝 PHP 開發頭文件:
    apt-get install php5-dev(PHP7 用 php-dev)
  4. 生成 configure:
    phpize
  5. 配置並編譯:
    ./configure --enable-xdebug
    make && make install
  6. 編輯 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"
  7. 重啟 Apache:
    service apache2 restart
  8. 驗證:
    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_hostIDE 所在 IP127.0.0.1 或宿主機 IP
xdebug.remote_port除錯埠9000
xdebug.remote_autostart每請求自動連接 IDE1 (開發環境)
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 監聽設定。
copyright © 萬盛學電腦網 all rights reserved