在VS Code中设置PHP开发环境并使用Xdebug调试-VSCode-PHP中文网

在VS Code中设置PHP开发环境并使用Xdebug调试

P粉986688829

发布： 2025-12-04 19:21:06

原创

981人浏览过

在VS Code中配置PHP开发环境并启用Xdebug调试需完成三步：安装PHP（CLI）、配置Xdebug扩展、使用PHP Debug插件连接；关键在于路径正确、端口一致（默认9003）、php.ini与launch.json端口匹配、pathMappings映射准确。

在vs code中设置php开发环境并使用xdebug调试

在 VS Code 中配置 PHP 开发环境并启用 Xdebug 调试，核心是三件事：装好 PHP（含 CLI）、配对 Xdebug 扩展、用 VS Code 的 PHP Debug 插件连接调试器。只要路径对、端口通、配置准，断点就能停住。

安装并验证本地 PHP 环境

VS Code 本身不运行 PHP，它依赖你系统已安装的 PHP 解释器。先确认命令行能调用 php：

终端输入 php -v，看到版本号（如 8.1+）说明已安装
输入 php -m | grep xdebug，若无输出，说明 Xdebug 还没装或没启用
推荐用 windows.php.net（Windows）或 brew install php（macOS）获取干净 PHP 包，避免 MAMP/XAMPP 带来的路径混乱

安装并配置 Xdebug（以 PHP 8.0+ 为例）

Xdebug 3 与旧版配置差异大，别套用网上 Xdebug 2 的 php.ini 写法。正确步骤如下：

用 php -v 查看 PHP 版本和架构（如 Thread Safe 或 Non-Thread Safe），去 xdebug.org/download 下载对应 .dll（Windows）或 .so（macOS/Linux）文件
把下载的 xdebug.so 或 php_xdebug.dll 放到 PHP 的 ext/ 目录下
编辑 php.ini（用 php --ini 找准确路径），在末尾添加：

[xdebug]
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.log=/tmp/xdebug.log  ; 临时开启，查连不上时看日志

登录后复制

注意：xdebug.client_port 默认是 9003（不是旧版的 9000），VS Code 插件默认也连这个端口，保持一致才不会“断点不触发”。

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

在 VS Code 中安装插件并配置 launch.json

打开 VS Code，装两个关键插件：

PHP Intelephense（代码提示、跳转、错误检查）
PHP Debug（由 Felix Becker 维护，支持 Xdebug 3）

然后在项目根目录创建 .vscode/launch.json（可通过命令面板 → “Debug: Open launch.json” 自动生成）：

Kuwebs企业网站管理系统3.1.5 UTF8

酷纬企业网站管理系统Kuwebs是酷纬信息开发的为企业网站提供解决方案而开发的营销型网站系统。在线留言模块、常见问题模块、友情链接模块。前台采用DIV+CSS，遵循SEO标准。 1.支持中文、英文两种版本，后台可以在不同的环境下编辑中英文。 3.程序和界面分离，提供通用的PHP标准语法字段供前台调用，可以为不同的页面设置不同的风格。 5.支持google地图生成、自定义标题、自定义关键词、自定义描

查看详情

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for Xdebug",
      "type": "php",
      "request": "launch",
      "port": 9003,
      "pathMappings": {
        "/var/www/html": "${workspaceFolder}"
      }
    }
  ]
}
</font>
<p>重点说明：</p>
<ul>
  <li><strong>port 必须和 php.ini 里的 xdebug.client_port 一致</strong></li>
  <li><strong>pathMappings</strong> 是关键！左边是服务器上 PHP 实际运行的绝对路径（比如 Docker 容器里是 /var/www/html），右边是本地项目路径。本地开发没容器就写成 <strong>"${workspaceFolder}": "${workspaceFolder}"</strong></li>
  <li>启动调试前，先点左下角绿色 ▶️ 启动监听，再在浏览器访问脚本（如 http://localhost/test.php），断点才会生效</li>
</ul>

<H3>验证调试是否成功</H3>
<p>写个简单 test.php：</p>
<font size="2">
<pre class="brush:php;toolbar:false;">
<?php
$x = 1;
var_dump($x); // 在这行左侧灰色区域点击设断点
echo "hello";
?>

登录后复制

操作流程：