文档内容来自xdebug.org/docs,翻译时xdebug版本为2.6。我在官方文档基础上针对中文排版和教程内容的编排做了一些优化,希望中文文档看起来更容易理解。
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/-xdebug
例如:
brew install homebrew/php/php71-xdebug
您也可以使用brew搜索找到您需要的特定软件包:
brew search xdebug
通过Homebrew安装的Xdebug扩展将在安装后默认启用,扩展的额外配置通过向/usr/local/etc/php//conf.d/添加自定义的ini文件来完成。有关更多详细信息,请参考安装结束时brew在终端的输出。
通过编译源码进行安装
获取源码
您可以通过三种渠道获得Xdebug源码:
PHP官方扩展库网站:下载链接
Xdebug官网:下载链接
github release:下载链接
编译
您从PHP的其余部分分别编译Xdebug。但请注意,您需要访问脚本“phpize”和“php-config”。如果你的系统没有“phpize”和“php-config”,你将需要首先编译和安装PHP源代码,因为这些脚本是PHP编译和安装过程的副产品。(Debian用户可以安装所需的工具 apt-get install php5-dev)。源版本与安装的版本相匹配非常重要,因为PHP版本之间存在轻微但重要的区别。一旦你有权访问“phpize”和“php-config”,请执行以下操作:
解压源码压缩包。请注意,您不需要解压缩PHP源代码树中的压缩包。如上所述,Xdebug是独立编译的。
tar -xzf xdebug-2.5.5.tgz。
进入Xdebug目录
cd xdebug-2.5.5
运行phpize(如果phpize不在你的路径中,使用绝对路径/ path / to / phpize)。确保你使用属于你想使用Xdebug的PHP版本的phpize。如果您在查找要使用的phpize时遇到问题,请参考常见问题解答。
phpize
检查编译条件
./configure --enable-xdebug
执行源码编译操作
make
安装(权限不够,请加sudo)
make install
配置PHP以使用Xdebug
将以下行添加到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。否则,他们将无法正常工作。
重启webserver/php-fpm
编写一个调用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