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

轻墨小哥_6630

轻墨小哥_6630

2025-11-26

632人浏览

原创

首先安装配置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需对应本地项目文件夹。

启动调试与触发断点

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

AgentGen — HTML to PDF & Image
AgentGen — HTML to PDF & Image

将 HTML 转换为 PDF 和图片。无需注册,免费版开箱即用(每分钟 1 次请求,含水印)。如需更高频次及去水印……

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

远程服务器调试配置

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

  • 确保远程服务器能访问你的开发机(防火墙开放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调试控制台输出,逐步排查连接或映射错误。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2415

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

4042

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1336

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4699

7

cookie
cookie

Cookie 是一种在用户计算机上存储小型文本文件的技术,用于在用户与网站进行交互时收集和存储有关用户的信息。当用户访问一个网站时,网站会将一个包含特定信息的 Cookie 文件发送到用户的浏览器,浏览器会将该 Cookie 存储在用户的计算机上。之后,当用户再次访问该网站时,浏览器会向服务器发送 Cookie,服务器可以根据 Cookie 中的信息来识别用户、跟踪用户行为等。

2023.06.30

13239

10

document.cookie获取不到怎么解决
document.cookie获取不到怎么解决

document.cookie获取不到的解决办法:1、浏览器的隐私设置;2、Same-origin policy;3、HTTPOnly Cookie;4、JavaScript代码错误;5、Cookie不存在或过期等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.23

1406

5

阻止所有cookie什么意思
阻止所有cookie什么意思

阻止所有cookie意味着在浏览器中禁止接受和存储网站发送的cookie。阻止所有cookie可能会影响许多网站的使用体验,因为许多网站使用cookie来提供个性化服务、存储用户信息或跟踪用户行为。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

904

5

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

2025.08.19

2046

14

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

7367

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程