当前位置: 首页 > 文档资料 > xdebug 中文文档 >

1.2 安装

优质
小牛编辑
131浏览
2023-12-01

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//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