在使用 VS Code 进行 PHP 代码调试时，Xdebug 可能会意外地停止在函数声明处，而非预设的断点位置，导致调试流程中断。这个问题通常是由于使用的 PHP 和 Xdebug 版本不兼容，以及 VS Code 插件的 resolved_breakpoints 功能引起的。本文将提供针对此问题的解决方案，包括临时禁用该功能以及检查其他可能导致调试异常的原因。
问题分析
Xdebug 调试过程中，如果调试器停止在函数声明处，而不是你设置的断点处，这通常表明 Xdebug 在断点解析上存在问题。特别是当使用的 PHP 和 Xdebug 版本较旧时，这个问题更为常见。VS Code 的 PHP Debug 插件中的 resolved_breakpoints 功能可能会加剧此问题。
解决方案
禁用 resolved_breakpoints 功能（临时方案）
一个临时的解决方案是禁用 VS Code PHP Debug 插件的 resolved_breakpoints 功能。这可以通过在 launch.json 配置文件中添加 xdebugSettings 来实现。
打开 .vscode/launch.json 文件，找到你的调试配置（例如 “Listen for XDebug” 或 “Launch currently open script”），并在该配置中添加以下内容：
{ "name": "Listen for XDebug", "type": "php", "request": "launch", "port": 9090, "xdebugSettings": { "resolved_breakpoints": "0" } }
这段配置告诉 Xdebug 禁用断点解析功能，这可以避免调试器错误地停止在函数声明处。
升级 PHP 和 Xdebug 版本（推荐方案）
最有效的解决方案是升级你的 PHP 和 Xdebug 版本。旧版本的 Xdebug 可能存在已知的问题，这些问题在新版本中已经得到修复。
升级 PHP: 访问 PHP 官方网站 (https://www.php.cn/link/7b8cc7bf27b727ec89a8f284b316d98d) 下载最新版本的 PHP。
升级 Xdebug: 使用 PECL 命令安装或升级 Xdebug：
pecl install xdebug
安装完成后，确保在 php.ini 文件中启用 Xdebug 扩展。
zend_extension=xdebug.so
重启你的 Web 服务器 (例如 Apache) 以使更改生效。
检查 Watch 面板中的变量
在 Xdebug 3.1.0 之前的版本中，eval 损坏的代码会导致调试引擎停止正常工作。如果在 Watch 面板中添加了变量，Xdebug 可能会尝试 eval 这些变量，如果变量表达式存在问题，可能会导致调试器停止。
尝试清空 Watch 面板，看看是否能解决问题。
注意事项
确保 launch.json 文件中的端口号 (通常是 9000 或 9090) 与 php.ini 文件中 Xdebug 的配置一致。检查你的防火墙设置，确保 VS Code 和 Xdebug 之间的通信没有被阻止。如果问题仍然存在，尝试重启 VS Code 和你的 Web 服务器。
总结
Xdebug 在 VS Code 中停止在不存在的断点上的问题通常可以通过禁用 resolved_breakpoints 功能或升级 PHP 和 Xdebug 版本来解决。同时，检查 Watch 面板中的变量也是一个值得尝试的步骤。通过以上方法，你应该能够恢复正常的 PHP 代码调试流程。
以上就是Xdebug 在 VS Code 中停止在不存在的断点上的问题解决的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1321783.html
微信扫一扫 
支付宝扫一扫 
