Xdebug中文文檔-安裝

文檔內容來自xdebug.org/docs，翻譯時xdebug版本爲2.6。我在官方文檔基礎上針對中文排版和教程內容的編排作了一些優化，但願中文文檔看起來更容易理解。

英文原始文檔地址： https://xdebug.org/docs/
中文文檔github地址： https://github.com/Anoxia/xde...

Windows預編譯的模塊

有幾個Windows預編譯模塊，它們都是PHP的非調試版本。你能夠在下載 頁面得到這些信息。按照這些指示安裝Xdebug。

類UNIX系統下使用PECL安裝

從Xdebug 0.9.0開始，你能夠經過PEAR / PECL安裝Xdebug。這隻適用於PEAR版本0.9.1-dev或更高版本。

使用PEAR / PECL進行安裝很是簡單：

pecl install xdebug

而後將xdebug擴展配置添加到您的php.ini中：（配置時注意擴展所在路徑，推薦使用絕對路徑）

zend_extension="/usr/local/php/modules/xdebug.so"

__注意：__請不要將配置寫成extension = xdebug.so， 這會致使加載xdebug擴展失敗。

macOS上經過Homebrew安裝

PHP和Xdebug能夠經過非官方的macOS包管理器Homebrew進行安裝。若是您是使用Homebrew安裝的PHP（使用Homebrew安裝PHP的安裝指南）那麼很容易經過brew install來安裝Xdebug：

brew install homebrew/php/<php-version>-xdebug

例如：

brew install homebrew/php/php71-xdebug

您也可使用brew搜索找到您須要的特定軟件包：

brew search xdebug

經過Homebrew安裝的Xdebug擴展將在安裝後默認啓用，擴展的額外配置經過向/usr/local/etc/php/<php-version>/conf.d/添加自定義的ini文件來完成。有關更多詳細信息，請參考安裝結束時brew在終端的輸出。

經過編譯源碼進行安裝

獲取源碼

您能夠經過三種渠道得到Xdebug源碼：

1. PHP官方擴展庫網站：下載連接
2. Xdebug官網：下載連接
3. github release：下載連接

編譯

您從PHP的其他部分分別編譯Xdebug。但請注意，您須要訪問腳本「phpize」和「php-config」。若是你的系統沒有「phpize」和「php-config」，你將須要首先編譯和安裝PHP源代碼，由於這些腳本是PHP編譯和安裝過程的副產品。（Debian用戶能夠安裝所需的工具 apt-get install php5-dev）。源版本與安裝的版本相匹配很是重要，由於PHP版本之間存在輕微但重要的區別。一旦你有權訪問「phpize」和「php-config」，請執行如下操做：

1. 解壓源碼壓縮包。請注意，您不須要解壓縮PHP源代碼樹中的壓縮包。如上所述，Xdebug是獨立編譯的。

   tar -xzf xdebug-2.5.5.tgz。

2. 進入Xdebug目錄

   cd xdebug-2.5.5

3. 運行phpize（若是phpize不在你的路徑中，使用絕對路徑/ path / to / phpize）。確保你使用屬於你想使用Xdebug的PHP版本的phpize。若是您在查找要使用的phpize時遇到問題，請參考常見問題解答。

   phpize

4. 檢查編譯條件

   ./configure --enable-xdebug

5. 執行源碼編譯操做

   make

6. 安裝（權限不夠，請加sudo）

   make install

配置PHP以使用Xdebug

1. 將如下行添加到php.ini中：

   zend_extension =「/path/to/xdebug.so」

   對於早於5.3的PHP版本和PHP（Apache 2 worker MPM或ISAPI模塊）的線程化使用，請添加：

   zend_extension_ts =「/path/to/xdebug.so」

   注意：若是你本身編譯了PHP而且使用了--enable-debug，請使用zend_extension_debug。

   注意：若是您想與OPCache一塊兒使用Xdebug，必須在OPCache以後加載Xdebug。不然，他們將沒法正常工做。

2. 重啓webserver/php-fpm
3. 編寫一個調用 phpinfo() 的PHP頁面在瀏覽器中加載它並查找Xdebug模塊上的信息。若是您在Zend徽標旁邊看到它，那麼您已經成功了！

   若是您使用PHP的命令行版本，你也可使用php -m，它列出全部加載的模塊。Xdebug應該出現兩次（一次在PHP下，一次在Zend Extension下面）。

兼容性

Xdebug不能與Zend Optimizer或任何其餘處理PHP內部的擴展（DBG，APD，ioncube等）一塊兒使用。這是因爲這些模塊的兼容性問題。

DEBUGCLIENT安裝

debugclient在Xdebug源碼目錄下：

# 進入debugclient目錄
cd debugclient
# 檢查編譯依賴
./configure --with-libedit
# 編譯
make
# 安裝
make install

這將在/usr/local/bin中安裝debugclient二進制文件。，若是您的系統上沒有安裝libedit，請安裝它，而後您能夠省去--with-libedit選項。Debian ‘unstable'用戶能夠安裝這個庫apt-get install libedit-dev libedit2。

若是配置腳本找不到libedit，而且您肯定已經正確安裝（而且是頭文件），而且在configure.log文件中出現如下連接錯誤：

/usr/lib64/libedit.so: undefined reference to `tgetnum'
/usr/lib64/libedit.so: undefined reference to `tgoto'
/usr/lib64/libedit.so: undefined reference to `tgetflag'
/usr/lib64/libedit.so: undefined reference to `tputs'
/usr/lib64/libedit.so: undefined reference to `tgetent'
/usr/lib64/libedit.so: undefined reference to `tgetstr'
collect2: ld returned 1 exit status

您須要將您的配置命令更改成：

LDFLAGS = -lncurses ./configure --with-libedit