安装

Windows预编译的模块

有几个Windows预编译模块，它们都是PHP的非调试版本。你可以在下载 页面获得这些信息。按照这些指示安装Xdebug。

类UNIX系统下使用PECL安装

从Xdebug 0.9.0开始，你可以通过PEAR / PECL安装Xdebug。这只适用于PEAR版本0.9.1-dev或更高版本。

使用PEAR / PECL进行安装非常简单：

  1. pecl install xdebug

然后将xdebug扩展配置添加到您的php.ini中：（配置时注意扩展所在路径，推荐使用绝对路径）

  1. 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：

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

例如：

  1. brew install homebrew/php/php71-xdebug

您也可以使用brew搜索找到您需要的特定软件包：

  1. brew search xdebug

通过Homebrew安装的Xdebug扩展将在安装后默认启用，扩展的额外配置通过向/usr/local/etc/php//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是独立编译的。

    1. tar -xzf xdebug-2.5.5.tgz。

  2. 进入Xdebug目录

    1. cd xdebug-2.5.5

  3. 运行phpize（如果phpize不在你的路径中，使用绝对路径/ path / to / phpize）。确保你使用属于你想使用Xdebug的PHP版本的phpize。如果您在查找要使用的phpize时遇到问题，请参考常见问题解答。

    1. phpize

  4. 检查编译条件

    1. ./configure --enable-xdebug

  5. 执行源码编译操作

    1. make

  6. 安装（权限不够，请加sudo）

    1. make install

配置PHP以使用Xdebug

  1. 将以下行添加到php.ini中：

    1. zend_extension =“/path/to/xdebug.so”

    对于早于5.3的PHP版本和PHP（Apache 2 worker MPM或ISAPI模块）的线程化使用，请添加：

    1. 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源码目录下：

  1. # 进入debugclient目录
  2. cd debugclient
  3. # 检查编译依赖
  4. ./configure --with-libedit
  5. # 编译
  6. make
  7. # 安装
  8. make install

这将在/usr/local/bin中安装debugclient二进制文件。，如果您的系统上没有安装libedit，请安装它，然后您可以省去--with-libedit选项。Debian ‘unstable’用户可以安装这个库apt-get install libedit-dev libedit2。

如果配置脚本找不到libedit，并且您确定已经正确安装（并且是头文件），并且在configure.log文件中出现以下链接错误：

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

您需要将您的配置命令更改为：

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