VSCode配置PHP开发环境 - Xdebug3.03

前言：

网上参考了很多安装配置教程，最后都无法在vscode中断点调试，最终发现是Xdebug3.x版配置项更新了，和Xdebug2.x版配置项名称差异比较多，特写此文帮助大家

一、下载XAMPP，安装

XAMPP下载地址

官网下载：https://www.apachefriends.org/zh_cn/download.html

我下载的是 7.4.15版(xampp-portable-windows-x64-7.4.15-0-VC15-installer.exe)。

安装过程中根据自己的需求选择安装项目

安装完成后，我只使用php，只启动了Apache

添加系统变量

把PHP.exe所在文件夹路径（例如：D:\Program Files\xampp\php）添加进环境变量-系统变量-Path中（直接搜索框搜索系统变量便可找到）。

在cmd中输入php -v，检查是否配置成功
配置成功

二、 下载xdebug插件

下载地址：https://xdebug.org/download

检查PHP版本信息

检查自己安装的PHP版本信息，查找处应该下载上面的哪个链接；

打开记事本，填入以下代码：

<?php   
    phpinfo();    
?>

另存为一个php文件，例如文件名为：phpinfo.php

将该文件放置在D盘根目录；CMD执行“php d:/phpinfo.php”查看版本信息。

如上：我的版本信息是 7.4.15   64位，TS 线程安全版本。对应下载 PHP 7.4 VC15 TS(64 bit)

将Xdebug配置信息写进PHP配置

把下载的x-debug文件（php_xdebug-3.0.3-7.4-vc15-x86_64.dll）复制到php\ext文件夹下(例如我的是：D:\Program Files\xampp\php\ext)
用记事本修改php.ini文件，在文件末尾添加几行配置信息，然后保存。

注意：

此处配置信息为Xdebug最新版3.03的配置项名称，和2.x版本不同，填写错误会无法使用。

三、下载并安装VSCode

下载地址：https://code.visualstudio.com/

在VSCode中安装调试插件

1、点击扩展栏，输入PHP，选择PHP Debug安装。

2、点击VSCode的 文件-首选项-设置（不同版本可能显示不同，注意查找用户设置），在设置里面的扩展找到php，点击setting.json添加以下一行配置：

"php.validate.executablePath": "D:/Program Files/xampp/php/php.exe",
//地址是php.exe文件所在的位置

里面的php.exe替换成自己的安装路径。

3、配置Debug

   1>选择 VSCode的左侧列表的“资源管理器”选项

    2>菜单操作：文件-打开文件夹  选择 D:\Program Files\xampp\htdocs 路径(注意替换成自己的路径)

   

3>在此文件夹内新建一个test.php文件

4.单击VSCode左侧列表的运行和调试图标，创建launch.json文件，环境选择PHP

注意：

默认的launch.json中port为9000，由于Xdebug3.03的默认调试端口已改为9003，所以此处需要改为9003。

4、然后简单调试下，验证配置是否成功。设置断点，然后vscode菜单中选择“运行(R)-启动调试”启动调试。

5、在浏览器中打开要调试的php（不是文件路径而是服务器的地址(http://localhost:/test.php)）,VSCode就会命中到打断点的地方。

---

Xdebug3和Xdebug2配置项差异介绍：

https://xdebug.org/docs/upgrade_guide#changed-xdebug.remote_autostart

参考博文

https://blog.csdn.net/qq_44803335/article/details/108806851