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

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

P粉986688829

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

原创

955人浏览过

在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” 自动生成）：

启科网络PHP商城系统

启科网络商城系统由启科网络技术开发团队完全自主开发，使用国内最流行高效的PHP程序语言，并用小巧的MySql作为数据库服务器，并且使用Smarty引擎来分离网站程序与前端设计代码，让建立的网站可以自由制作个性化的页面。系统使用标签作为数据调用格式，网站前台开发人员只要简单学习系统标签功能和使用方法，将标签设置在制作的HTML模板中进行对网站数据、内容、信息等的调用，即可建设出美观、个性的网站。

查看详情

{
  "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";
?>

登录后复制

操作流程：