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