安装 xDebug

通用步骤

  1. 添加一个test.php,添加一行代码 phpinfo() ,然后把输出的内容全部复制,粘贴到 https://xdebug.org/wizard.php
  1. 该网站会分析其内容,然后给出适合你环境的安装步骤,按照它的步骤来安装即可:

  1. 安装完之后,找到 php.ini 文件,在文件末尾添加下面配置:
[XDebug]
xdebug.remote_enable = 1
xdebug.remote_autostart = 1
  1. 重启 apache 服务器

以上步骤适用于 Linux,Windows 系统。

VS Code 调试

安装 PHP Debug 插件即可

PHPSTORM 调试

打开工具栏的调试监听按钮即可,下图是未打开时的情况:

CLI 调试

  1. 同样按照通用步骤完成前两步之后(如果已经按照这个步骤安装过xdebug了,就直接进入下一步),

  2. 将下列源代码添加到 cli 版本的 php.ini 的末尾,保存即可。

[XDebug]
xdebug.remote_enable = 1
xdebug.remote_autostart = 1
  1. 这时,打开 phpstorm 或 vscode 的调试监听按钮,运行php脚本,就会自动中断到断点处了。

注:Ubuntu 中不同版本的 php cli 的配置文件在:

# php 5.6
/etc/php/5.6/cli/php.ini
# php 7.0
/etc/php/7.0/cli/php.ini
# php 7.1
/etc/php/7.1/cli/php.ini
# php 7.2
/etc/php/7.2/cli/php.ini

FAQ

Windows10 XAMPP 按照上面的步骤,始终无法启用 xDebug 模块。

【原因】最新版的 XAMPP 附带的是 PHP7.3 版本,对应的 xdebug.dll 版本还没有编译,所以无效。
【解决】使用 PHP7.2 版本安装对应的 xdebug.dll 即可