VSCode PHP调试_Xdebug配置与远程调试-VSCode-PHP中文网

VSCode PHP调试_Xdebug配置与远程调试

幻影之瞳

发布： 2025-11-26 18:51:59

原创

519人浏览过

首先安装配置Xdebug扩展并修改php.ini，然后在VSCode中安装PHP Debug插件并设置launch.json，最后启动监听并通过参数或浏览器插件触发调试。

要在vscode中配置php调试，尤其是使用xdebug进行本地或远程调试，关键在于正确设置php环境、xdebug扩展以及vscode的调试配置。下面详细介绍如何一步步完成配置。

安装与配置Xdebug

Xdebug是PHP的调试工具，必须先在服务器环境中安装并启用。

确认PHP版本：运行php -v查看当前PHP版本，前往Xdebug官网下载对应版本的扩展。
修改php.ini：找到PHP的配置文件（可通过php --ini定位），添加如下内容（以本地调试为例）：

[XDebug]
zend_extension=xdebug.so ; Linux/Mac
; zend_extension=xdebug.dll ; Windows
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.log="/tmp/xdebug.log" ; 可选：用于排查连接问题

重启Web服务（如Apache或PHP内置服务器），然后执行php -m | grep Xdebug确认是否加载成功。

VSCode中配置PHP Debug插件

VSCode需要安装PHP Debug扩展来支持断点调试。

打开VSCode，进入扩展市场搜索“PHP Debug”，由Felix Becker维护的插件最受欢迎。
安装完成后，项目根目录下创建.vscode/launch.json文件，内容如下：

{ "version": "0.2.0", "configurations": [ { "name": "Listen for Xdebug", "type": "php", "request": "launch", "port": 9003, "pathMappings": { "/var/www/html": "${workspaceFolder}" }, "log": true }, { "name": "Launch Built-in Web Server", "type": "php", "request": "launch", "runtimeExecutable": "php", "program": "${workspaceFolder}/index.php", "cwd": "${workspaceFolder}", "port": 9003 } ] }

pathMappings特别重要，用于映射服务器路径到本地路径。例如Docker或远程服务器中的/var/www/html需对应本地项目文件夹。

启动调试与触发断点

配置完成后，就可以开始调试了。

在VSCode中选择“Listen for Xdebug”配置，点击绿色三角启动监听。
访问目标PHP页面，附加以下参数触发调试：
?XDEBUG_TRIGGER=1 或设置浏览器Cookie XDEBUG_SESSION=1。
推荐安装浏览器扩展（如“Xdebug Helper”），一键开启/关闭调试会话。
在代码中设置断点，刷新页面即可进入调试模式，查看变量、调用栈等信息。

远程服务器调试配置

如果PHP运行在远程服务器（如VPS、Docker容器或生产测试环境），需调整网络和路径映射。

知海图Chat

知乎与面壁智能合作推出的智能对话助手

157

查看详情

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

确保远程服务器能访问你的开发机（防火墙开放9003端口）。
修改xdebug.client_host为你的本地IP（非localhost），例如：
xdebug.client_host=192.168.1.100
更新launch.json中的pathMappings，确保远程文件路径与本地一致。
使用SSH隧道可提高安全性：
ssh -R 9003:127.0.0.1:9003 user@remote-server

基本上就这些。只要Xdebug正常加载，VSCode监听开启，并且路径和网络配置正确，调试就能顺利运行。遇到问题可以查看Xdebug日志和VSCode调试控制台输出，逐步排查连接或映射错误。

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