VSCode配置PHP开发环境 VSCode运行PHP脚本配置方法-VSCode-PHP中文网

vscode本身不运行php，只调用系统php命令；必须先确保终端能执行php -v，否则intelephense、xdebug、格式化等功能全部失效，windows需配置系统path，macos需brew link，linux建议显式设置php.executablepath。

vscode配置php开发环境 vscode运行php脚本配置方法

VSCode 本身不运行 PHP，它只调用你系统里装好的 php 命令；没装 PHP 或路径配错，所有功能都会卡在第一步——连 php -v 都报错，就别谈调试、跳转、格式化了。

确认终端能执行 `php -v`，否则一切免谈

这是最常被跳过的硬前提。VSCode 的 PHP 功能（包括 Intelephense 启动、Xdebug 连接、格式化）全依赖这个命令可用。

Windows 用户：检查是否把 C:\xampp\php 或 C:\wamp64\bin\php\php8.2.12 加进了「系统环境变量 PATH」，不是用户变量，且改完要重启 VSCode（或至少关掉再开集成终端）
macOS 用户：Homebrew 安装的 php@8.2 默认不软链到 /usr/local/bin/php，必须手动运行 brew link php@8.2；验证用 which php，别只信 php -v
Linux 用户：若用源码编译安装，php 可能只在当前 shell 的 $PATH 里，而 VSCode 图形界面启动时不会继承该环境，建议直接填绝对路径（如 /opt/php/bin/php）
路径里含空格或中文？别硬扛——重装到纯英文路径（如 C:\php），比加引号更稳妥

在 VSCode 设置里显式填 `php.executablePath`

即使终端能跑 php -v，VSCode 仍可能找不到它——尤其 macOS 使用 zsh、Windows 用非管理员方式启动时，环境变量隔离很常见。显式配置是最稳解法。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

打开设置（Ctrl+, 或 Cmd+,），搜 php executable path
填绝对路径：C:\xampp\php\php.exe（Windows）、/opt/homebrew/bin/php（macOS Apple Silicon）、/usr/bin/php（Linux）
填完不用重启，但建议关掉所有 .php 文件再重开，避免 Intelephense 缓存旧状态
如果右下角没显示 PHP 版本号，说明这步失败；此时 Intelephense 会提示 “PHP language server is not running”

装对扩展，别堆插件合集包

日常开发真正需要的只有两个扩展，装多反而冲突。所谓“PHP Extension Pack”这类合集包，常捆绑已弃用的旧版 PHP Debug，会导致断点灰色、launch.json 不识别。

PHP Intelephense（Ben Mewburn 开发）：提供跳转、补全、类型推断；比 VSCode 内置语言支持强得多
PHP Debug（Felix Becker 维护）：对接 Xdebug 实现断点；注意它不自带 Xdebug，只是客户端
别装 PHP CS Fixer 和 PHP_CodeSniffer 两个格式化插件——选一个并配死；推荐 php-cs-fixer，规则全、维护活跃
装完后打开任意 .php 文件，右下角应显示 PHP 版本号；不显示，先回退检查前两步

用 `php -S` 启动本地服务器，别双击打开文件

PHP 文件不能像 HTML 那样双击或拖进浏览器看效果。浏览器不执行 PHP，只会显示源码或报 500——真错误信息全在终端里。

在项目根目录打开 VSCode 集成终端，运行：php -S localhost:8000 -t public/（假设入口在 public/index.php）
若需路由重写（如 Laravel），加 router.php：php -S localhost:8000 router.php -t public/，内容至少为 <?php return false;
浏览器访问 http://localhost:8000，不是 file:///xxx/index.php
改代码后不会自动刷新——php -S 不监听文件变化，必须手动 Ctrl+C 停掉再重跑；可配 nodemon --exec php -S localhost:8000 简化流程

最容易被忽略的是：Xdebug 断点只在 CLI 模式（F5 直接运行脚本）或 Web 请求（配合 php -S + 正确 pathMappings）下生效，但两者配置逻辑不同；很多人卡在 launch.json 里写了 "program": "${file}" 却没意识到这只能调试单文件 CLI，没法捕获浏览器发起的请求。