PHP文件无法直接双击预览,必须通过本地PHP服务器(如php -S)运行,浏览器访问http://地址才能执行并显示HTML结果;VS Code需用PHP Server插件而非Live Server。

PHP 文件本身不能“直接打开预览”——它不是静态网页,必须经 PHP 解释器执行后才生成 HTML 输出。所谓“实时预览”,本质是启动本地 PHP 服务,让浏览器通过 http:// 访问,而非双击用文本编辑器或浏览器直接打开 .php 文件(那样只会看到源码或报错)。
用内置 PHP 服务器快速启动预览
PHP 5.4+ 自带轻量级开发服务器,适合单文件或小项目快速验证:
- 确保终端在 PHP 文件所在目录,运行:
php -S localhost:8000 - 如果入口是
index.php,直接访问http://localhost:8000即可;若为其他文件(如test.php),需访问http://localhost:8000/test.php - 该服务器不解析
.htaccess,也不支持 Apache/Nginx 的重写规则;路由逻辑需手动在路由器脚本中处理(如传入-t或用router.php) - 每次修改 PHP 文件后,刷新浏览器即可看到效果——这就是最简“实时”
VS Code + PHP Server 插件实现一键预览
很多用户卡在“点了预览按钮没反应”,大概率是因为插件没配好路径或没启服务:
- 安装官方推荐插件:
PHP Server(by Brackets.io)或Live Server(但注意:Live Server默认不执行 PHP,需额外配置) - 右键 PHP 文件 → “Open with Live Server” 会失败,因为 Live Server 是纯静态服务器;必须改用
PHP Server插件的 “Start Server” 命令 - 插件默认监听
localhost:3000,但实际端口可能被占——可在 VS Code 设置里搜phpserver.port手动改 - 插件启动后,状态栏显示 “PHP Server: Running”,此时点击链接或手动访问对应 URL 才生效
浏览器直接打开 .php 文件为什么只显示源码?
这是最常被误解的一点:浏览器没有 PHP 解释能力。当你双击 test.php,系统可能用记事本打开(显示代码),也可能用 Chrome 直接加载为 file:/// 协议——而现代浏览器出于安全限制,file:// 下的 PHP 文件根本不会执行,只会下载或展示纯文本。
立即学习“PHP免费学习笔记(深入)”;
- 错误现象示例:
Parse error: syntax error, unexpected 'echo' (T_ECHO)—— 这其实是 PHP 解析器在命令行报的错,不是浏览器报的;浏览器里看到的只是原始代码 - 确认是否真在跑服务?用
curl http://localhost:8000/test.php测试,有 HTML 输出才是正常;返回空白或 404 就说明服务没起来或路径不对 - Windows 用户尤其注意:CMD 中执行
php -S前,必须已将 PHP 加入系统 PATH,否则提示'php' is not recognized
真正影响“实时性”的从来不是工具链多炫酷,而是文件保存后是否触发了服务重载——PHP 内置服务器本身不监听文件变化,所以你改完代码只需手动刷新页面;如果需要自动刷新,得额外加 browser-sync 或前端构建工具代理,但这已经超出 PHP 预览的基本范畴了。











