WordPress本地开发软件Local:使用 Xdebug 插件实现开发调试

编辑文章

Xdebug 是什么

Xdebug 是一款用于 PHP 调试与开发 的扩展程序,在 Local 环境中启用后,可显著提升复杂 PHP 问题的排查效率。

增强版 var_dump() 输出

这是 Xdebug 最直观的功能之一。启用后,PHP 内置的 var_dump() 会输出结构清晰、可读性强的数据(如数组、对象),无需手动格式化。

错误与堆栈跟踪增强

Xdebug 会强化 PHP 的错误、警告与提示信息,并自动提供堆栈跟踪功能,清晰展示错误发生前调用的所有函数,帮助你迅速定位问题源头。

此功能会使错误信息更详细,因此在 Local 中看到的错误可能比生产环境更多。这是正常现象,有助于在开发阶段提前发现问题。

代码步进调试器

这是 Xdebug 的核心调试功能,支持以下操作:
* 在代码中设置断点
* 执行到断点时自动暂停
* 逐行或逐过程执行后续代码;
* 实时查看该时刻所有变量的值。

这对调试复杂业务逻辑或未知问题尤其有用。

启用与配置 Xdebug

安装插件

若要让编辑器(如 VS Code、PHPStorm)与 Local 中的 Xdebug 协同调试,需进行对应配置,Local 提供了官方插件来简化这一过程,选择插件进行安装并启用。

启用 Xdebug

在 Local 中选择目标站点,在主面板底部找到 Xdebug 开关,将其打开

写入配置

在网站工具类写入配置到vscode

可以在Vscode中检查是否成功写入