vs code 无法直接运行 php 文件,需用 php 内置服务器(php -s)启动本地 web 服务;确保 php 已安装并加入 path,单文件项目执行 php -s localhost:8000 -t .,浏览器访问 http://localhost:8000/index.php 即可。

PHP 文件在 VS Code 里点“运行”没反应?
VS Code 本身不执行 PHP,它只是编辑器。你看到的“运行”按钮(比如点击右上角三角)默认调用的是 php 命令行解释器,输出到终端,**不是浏览器**。想在浏览器里打开,得让 PHP 启动一个 Web 服务,把文件当 HTTP 请求处理。
常见错误现象:php: command not found、页面显示原始 PHP 代码、404、空白页但控制台没报错。
- 确认系统已安装 PHP:终端运行
php -v,有版本号才继续 - 确保
php命令在系统 PATH 中(Windows 用户尤其注意是否勾选了“Add to PATH”) - 别直接双击打开
.php文件——浏览器不会解析服务端代码
用 PHP 内置服务器快速启动(推荐本地开发)
PHP 5.4+ 自带轻量级开发服务器,适合调试单文件或小项目,不用配 Apache/Nginx。
操作很简单:在 VS Code 终端(Ctrl+`)进入你的 PHP 项目根目录,运行:
立即学习“PHP免费学习笔记(深入)”;
php -S localhost:8000
但这样会报错:Failed to open stream: No such file or directory,因为没指定路由脚本。正确写法是:
- 如果只有单个文件(比如
index.php),运行:php -S localhost:8000 -t . - 如果需要自定义路由(如处理所有请求都进
router.php),运行:php -S localhost:8000 router.php - 端口可换,但避免用 80(需管理员权限)、8080(常被代理占)
然后浏览器访问 http://localhost:8000/index.php 即可。
VS Code 插件能自动开服务器吗?
可以,但别装一堆“PHP Run”类插件——它们多数只是封装了 php CLI 命令,依然不走浏览器。真正有用的插件是:
-
PHP Server(by Brackets):右键文件 → “Serve project with PHP”,自动起php -S并打开浏览器 -
Live Server(by Ritwick Dey):**对 PHP 无效**,它只服务静态文件,PHP 会被当文本返回 - 别信“PHP Debug”插件能运行网页——它只负责断点调试,仍需先起服务
插件只是快捷方式,底层还是依赖你本地的 php 可执行文件。路径不对,插件一样报错。
为什么改了代码浏览器刷新没变化?
PHP 内置服务器默认不自动重启,也不监听文件变化。你改完 index.php,必须手动终止旧进程(Ctrl+C),再重跑命令。
更省事的办法:
- 用
npm装个监听工具:npx onchange "**/*.php" -- npm run serve(需提前写好"serve": "php -S localhost:8000 -t .") - Windows 用户可用
watchexec:watchexec -e php --on-change "php -S localhost:8000 -t ." --restart - 记住:浏览器缓存也可能导致“没变”,试试
Ctrl+F5强制刷新
真实开发中,这个环节最容易被忽略——你以为改了就生效,其实服务还卡在旧版本里。











