VSCode调试：PHP应用调试配置

要调试PHP应用需配置Xdebug与VSCode，先安装PHP、Xdebug及PHP Debug插件，再在php.ini中启用Xdebug并设置模式、端口等参数，接着在VSCode中创建launch.json配置监听端口与路径映射，最后启动调试并访问应用触发断点。

要在 VSCode 中调试 PHP 应用，核心是使用 Xdebug 配合 PHP Debug 插件。整个过程包括环境准备、配置 Xdebug、设置 VSCode 的 launch.json 文件。只要这几步正确，断点调试就能顺利运行。

1. 安装必要组件

确保你的开发环境中已安装以下内容：

• PHP：命令行可执行 php，建议版本 7.0 及以上
• Xdebug：PHP 扩展，用于提供调试能力
• VSCode PHP Debug 插件：在扩展商店搜索 "PHP Debug" 并安装（由 Felix Becker 维护）

安装 Xdebug 的方式取决于你的系统。例如，在 Ubuntu 上可通过：

如果你使用的是 Windows + WAMP/XAMPP，Xdebug 的 DLL 文件需手动下载并配置到 php.ini 中。

立即学习“PHP免费学习笔记（深入）”；

2. 配置 php.ini 启用 Xdebug

找到你的 php.ini 文件（可通过 php -i | grep 'php.ini' 查看路径），添加或修改以下内容（以 Xdebug 3 为例）：

说明：

白瓜面试

白瓜面试 - AI面试助手,辅助笔试面试神器

40

查看详情

• xdebug.mode=debug 表示启用调试模式
• xdebug.start_with_request=yes 表示每个请求都尝试连接调试器
• client_port=9003 是默认端口，与 VSCode 调试监听一致
• 日志路径有助于排查连接问题

保存后重启 Web 服务（如 Apache 或 PHP 内置服务器）。

3. 配置 VSCode launch.json

打开项目根目录，在 .vscode 目录下创建或编辑 launch.json，内容如下：

关键字段解释：

• port：必须与 xdebug.client_port 一致
• pathMappings：将服务器上的绝对路径映射到本地项目路径，尤其在使用 Docker 或远程服务器时必需
• log: true：开启调试器日志，输出到调试控制台，便于排错

4. 开始调试

调试流程如下：

• 在 VSCode 中打开一个 PHP 文件，点击左侧边栏第四个图标（运行和调试）
• 选择 “Listen for Xdebug” 配置，点击“运行”按钮（绿色三角）
• 访问你的 PHP 应用页面（如通过浏览器打开 http://localhost:8000）
• 如果一切正常，VSCode 会在你设置的断点处暂停执行

若未触发，检查 Xdebug 日志、确保没有防火墙阻拦 9003 端口，并确认 pathMappings 正确。

基本上就这些。配置一次后，后续项目只需复制 launch.json 和 Xdebug 设置即可复用。不复杂但容易忽略细节，比如路径映射或端口不一致。

以上就是VSCode调试：PHP应用调试配置的详细内容，更多请关注php中文网其它相关文章！