vs code 本身不执行 php,需本地安装 php cli 并配置环境;运行 php 需启动 web 服务(如内置服务器 php -s 或 xampp/mamp),且浏览器必须通过 http:// 访问而非 file://。

PHP 文件在 VS Code 里点“运行”没反应?不是 VS Code 的事
VS Code 本身不执行 PHP,它只是个编辑器。你点“运行”或按 F5,默认调用的是调试器(比如 PHP Debug 扩展),但前提是本地得有 PHP CLI 环境,且 Web 服务(如 Apache/Nginx)或内置服务器已就位——否则浏览器打不开,不是配置错了,是根本没启动服务。
- 检查终端里输入
php -v是否能输出版本号;不能 → 先装 PHP 并加进系统 PATH - VS Code 里打开的文件必须是
.php后缀,且保存了(未保存的临时文件不会被识别为可执行) - 别依赖右键菜单里的“Open in Browser”插件直接跑 PHP —— 它只开静态 HTML,不解析
<?php echo 'hi'; ?>
用 PHP 内置服务器快速预览(推荐开发阶段)
PHP 5.4+ 自带 php -S 命令,不用配 Apache,适合单文件或小项目快速验证逻辑和路由。
- 终端进入项目根目录(含
index.php的文件夹),运行:php -S localhost:8000
- 如果需要路由控制,加路由脚本:
php -S localhost:8000 router.php
,其中router.php要返回true或false控制是否接管请求 - 浏览器访问
http://localhost:8000/index.php,不是file:///xxx/index.php—— 后者是文件协议,PHP 不会执行 - 注意:内置服务器不支持 .htaccess、不处理并发、无重写规则,上线前务必换正式 Web 服务器
VS Code 配合 XAMPP / MAMP 点击即开浏览器
如果你已装 XAMPP(Windows/macOS)或 MAMP(macOS),目标是像前端那样点一下就弹出浏览器,关键在于路径映射和端口对齐。
- XAMPP 默认把
htdocs当 Web 根目录,把你的 PHP 项目放进去,比如:C: mpphtdocsmyappindex.php - 启动 XAMPP 控制面板里的 Apache,然后在 VS Code 里右键
index.php→ “Copy Relative Path”,再手动拼 URL:http://localhost/myapp/index.php - 想一键打开?装插件
open-in-browser,但必须确保文件路径在localhost可访问范围内;否则会 404 —— 这不是插件问题,是 Web 服务器没暴露该路径 - MAMP 用户注意端口:默认是
8888(Apache)和8889(Nginx),URL 得写成http://localhost:8888/myapp/index.php
调试时 F5 没反应?检查 php.ini 和 launch.json
VS Code 调试 PHP 需要两个条件同时满足:PHP 的 xdebug 或 zend_extension 已启用,且 .vscode/launch.json 配置指向正确的 PHP 可执行路径。
立即学习“PHP免费学习笔记(深入)”;
- 运行
php --ini查Loaded Configuration File,打开对应php.ini,确认有类似这行(Xdebug 3+):zend_extension=xdebug
,且没被注释 -
launch.json中runtimeExecutable必须是完整路径,比如"C:\php\php.exe"(Windows)或"/usr/bin/php"(macOS/Linux),不能只写"php"—— VS Code 调试器不读系统 PATH - 常见错误信息:
Could not open input file: -dxdebug.mode=debug,说明launch.json里写了错误的参数格式,Xdebug 3 应用"xdebugMode": "debug"字段,而非拼接命令行











