Xdebug 安装配置

发表于 2018-09-25 更新于 2022-10-25 分类于工具 Changyan：

在写这个文章前，我尝试了很多网上的安装配置教程，但结果要么不便捷，要么调都调不起来。于是我就去查看 Xdebug 官方文档，通过文档中的 Xdebug 远程调试原理图才逐渐知道如何正确的配置。后面再慢慢减少参数设置得到了一份配置少，使用方便的配置方案，在这篇文章里分享给大家。

环境说明

Windows
Vagrant + VirtualBox + CentOS 7 + Nginx + PHP
PhpStorm

配置前准备

检查 PHP 环境是否已经存在 Xdebug 拓展了

在命令行中输入 php -m 可以查看 PHP 已加载的拓展
了解自己环境的配置
- PHP 版本
- php.ini 所在地址
- 服务器系统位数 32位还是 64位
Xdebug 和 Phpstorm 交互的原理
- 服务器的IP和端口是 10.0.1.2:80
- IDE 的客户端IP是 10.0.1.42, 所以服务器上 xdebug.remote_host=10.0.1.42
- IDE 监听的调试端口为 9000, 所以服务器上 xdebug.remote_port=9000
- IDE 所在的客户端，对 Xdebug 的服务器进行请求
- Xdebug 与 10.0.1.42:9000 的客户端 IDE 监听端口关联
- 运行调试, Xdebug 所在的服务器提供 HTTP 响应
- 服务器的IP和端口是 10.0.1.2:80
- IDE 的客户端IP是一个未知的IP, 所以服务器上 xdebug.remote_connect_back=1
- IDE 监听的调试端口为 9000, 所以服务器上 xdebug.remote_port=9000
- 发出 HTTP 请求后，Xdebug 将从 HTTP 请求头获取 IP 地址
- Xdebug 会和从 HTTP 请求头获取 IP 地址的客户端 IDE 监听端口关联
- 运行调试, Xdebug 所在的服务器提供 HTTP 响应

下载缺少的扩展和软件

配置

PHP 添加 Xdebug 扩展

下载 Xdebug 扩展源码


cd /usr/local/src
wget https://xdebug.org/files/xdebug-2.7.0alpha1.tgz

解压
tar -zxvf xdebug-2.7.0alpha1.tgz

编译安装


cd xdebug-2.7.0alpha1

生成安装脚本
phpize

设置安装配置参数
vim install-sh
> /configure --with-php-config=/usr/local/php/bin/php-config

运行安装配置
sh install-sh

编译扩展，使用两个 cpu 内核运行（可以快很多）
make -j 2

编译安装
make install

注意：

编译安装后，会返回扩展所在文件夹。

php.ini 中添加 Xdebug 配置


[xdebug]
zend_extension="/usr/local/php/lib/php/extensions/no-debug-non-zts-20160303/xdebug.so"
xdebug.idekey="PHPSTORM"
xdebug.remote_enable = On
xdebug.remote_autostart=On
xdebug.remote_connect_back=On
xdebug.remote_port=9001