如何在VSCode中配置PHP开发调试环境？-VSCode-PHP中文网

如何在VSCode中配置PHP开发调试环境？

夢幻星辰

发布： 2025-11-14 19:09:06

原创

809人浏览过

答案是配置VSCode的PHP调试环境需安装PHP与Xdebug，设置php.ini启用扩展并配置调试参数，再安装Intelephense和PHP Debug扩展，最后在launch.json中配置监听端口与路径映射，启动调试即可。

如何在vscode中配置php开发调试环境？

要在VSCode中配置PHP开发调试环境，关键是安装必要的扩展并正确设置PHP解释器和Xdebug。只要把工具链配好，调试就能像其他语言一样顺畅。

安装PHP和Xdebug

确保系统中已安装PHP，并启用Xdebug扩展。这是实现断点调试的核心。

下载并安装PHP（建议使用PHP 8.x版本），并将php.exe所在路径加入系统环境变量
访问Xdebug官网向导，上传phpinfo()输出内容，获取适配的Xdebug版本
下载对应DLL文件放入PHP的ext目录，并在php.ini中添加加载语句，例如：
zend_extension=xdebug.dll

配置基本调试参数，如：

  
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003

登录后复制

保存后重启Web服务（如Apache或内置服务器），用php -m检查Xdebug是否加载

安装VSCode扩展

VSCode需要两个关键扩展来支持PHP调试：语法支持和调试协议对接。

在扩展市场搜索并安装PHP Intelephense，提供代码补全、跳转和语法检查
安装PHP Debug（由felixfbecker提供），这是连接Xdebug的核心插件
可选：安装PHP Snippets或Composer辅助插件提升效率

配置launch.json启动调试

调试前需告诉VSCode如何启动PHP脚本并监听Xdebug连接。

Eclipse中创建Web Maven Project并部署到Tomcat中中文WORD版

大家都知道，在进行J2EE项目的开发过程中，在调试阶段如果只是修改了页面是不需要重启应用服务器的，比如不需要重启Tomcat。只需要在浏览器中进行页面刷新即可。其实之所以不用重启Tomcat等应用服务器，其根本原因是因为我们可以在应用服务器的配置文件中设置虚拟目录，这样就可以知道web 项目所在的目录，于是就可以省去打包、然后再重新发布到服务器的步骤。感兴趣的朋友可以过来看看

查看详情

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

打开项目根目录，在.vscode文件夹下创建launch.json

写入以下配置：

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

登录后复制