VSCode配置PHP运行环境 - 本地调试与浏览器预览-VSCode-PHP中文网

能，但需满足三个硬性条件：终端当前目录下有可访问的入口文件（如index.php），php命令可用（php -v有输出），且不能用浏览器直接双击打开.php文件；执行php -s localhost:8000后，必须通过http://localhost:8000访问才触发php解析，否则显示源码说明未走解释器流程。

vscode配置php运行环境 - 本地调试与浏览器预览

php -S localhost:8000 能直接跑起来吗

能，但必须满足三个硬性条件：终端当前目录下有可访问的入口文件（如 index.php），php 命令在终端中可用（php -v 有输出），且没用浏览器直接双击打开 .php 文件。

执行 php -S localhost:8000 后，浏览器访问 http://localhost:8000 才算真正运行；如果看到源码、下载弹窗或 404，说明根本没走 PHP 解析流程。常见错误包括：

项目根目录下没有 index.php，或文件名拼错（比如写成 Index.php）
路径含中文或空格，某些 PHP 版本会静默失败（尤其 Windows 下）
端口被占用（比如另一进程占了 8000），但错误不报在浏览器，只显示在终端第一行

需要路由支持？加一个 router.php 文件，再运行 php -S localhost:8000 router.php。这个脚本必须返回 true 或输出内容，否则 404。

VSCode 找不到 php.exe 怎么办

不是插件坏了，是 VSCode 图形界面启动时压根没读到 shell 的 PATH —— macOS/Linux 用户尤其容易踩这个坑，Windows 用户若用 XAMPP 但没勾选「Add to PATH」也会一样。

别信设置里“自动检测”那一栏，它只查系统级 PATH，而 Homebrew、Laragon、PHPStudy 等工具默认不软链到通用路径。正确做法是手动填绝对路径：

macOS（Apple Silicon + Homebrew）：/opt/homebrew/bin/php
Windows（XAMPP）：C:\xampp\php\php.exe
Linux（apt 安装）：/usr/bin/php

填完必须重启 VSCode，然后按 Ctrl+Shift+P → 输入 PHP: Validate PHP Installation，看到 PHP is available 才算生效。路径里有空格？重装到纯英文无空格路径（如 C:\php），比加引号更稳。

page-agent 浏览器控制（CDP）

使用 page-agent CLI（CDP）控制浏览器；CLI只能通过 GitHub Release 的 .tgz 安装，npm 官方包暂未发布。

下载

断点灰色、hover 显示 “unbound breakpoint”

90% 是 pathMappings 写反了：Xdebug 发送的是服务器上脚本的绝对路径（比如 /var/www/html/index.php），VSCode 必须知道它对应你本地哪个文件夹。漏写、斜杠方向错、多一层 src 都会导致断点失效。

检查三处是否对齐：

php.ini 中启用：xdebug.mode=debug、xdebug.start_with_request=yes、xdebug.client_port=9003
launch.json 中 port 和 pathMappings 与上面一致，例如："pathMappings": { "/var/www/html": "${workspaceFolder}" }
确保 php -v 输出含 with Xdebug v3.x；没有就说明 zend_extension 路径错或扩展文件名不对（Windows 是 php_xdebug.dll，macOS/Linux 是 xdebug.so）