VSC如何运行PHP网页_本地服务器启动与访问【详解】

发布时间 - 2025-12-29 00:00:00    点击率:
VS Code 无内置 PHP 服务器,需用 PHP 内置服务器(php -S)启动;确保 php -v 可用,在项目根目录执行 php -S localhost:8000,支持 router.php 自定义路由。

VS Code 本身不带 PHP 本地服务器,必须借助外部工具或插件启动服务;直接双击打开 .php 文件只会看到源码或报错,无法执行 PHP 逻辑。

用 PHP 内置服务器快速启动(推荐初学者)

PHP 5.4+ 自带 php -S 命令,无需安装 Apache/Nginx,适合开发单页或简单项目。

  • 确保终端中运行 php -v 能正确输出版本(如 PHP 8.2.12),否则先配置系统 PATH
  • 在项目根目录(含 index.php)打开终端,执行:
    php -S localhost:8000
  • 默认会查找当前目录下的 router.php;若无此文件,仅支持直接请求已存在的 PHP 文件(如 http://localhost:8000/index.php
  • 如需美化路由(例如访问 /about 映射到 about.php),创建 router.php

VS Code 中一键启动 PHP 服务器(用插件)

手动敲命令容易忘端口、路径,用 PHP Server 插件可点一下就跑起来。

  • VS Code 扩展市场搜索并安装 PHP Server(作者:bradymholt)
  • 右键任意 .php 文件 → 选择 PHP Server: Serve project
  • 插件默认监听 localhost:8080,但会自动检测并避开被占用的端口
  • 注意:它只对当前打开的文件所在文件夹生效;如果项目有子目录结构,确保右键的是根目录下的入口文件(如 index.php
  • 启动后底部状态栏会出现 PHP Server: http://127.0.0.1:8080,点击即可在浏览器打开

常见打不开 / 报错原因

不是代码写错了,而是环境或路径没对上 —— 这类问题占本地运行失败的 80% 以上。

  • Command 'php' not found:系统找不到 PHP 可执行文件。Windows 用户检查是否勾选了安装时的 “Add PHP to PATH”;macOS 用户常用 brew install php,但新版本可能装成 php@8.2,需用 brew link php@8.2
  • 浏览器显示空白或源码:说明服务器根本没运行,或你访问的是 file:/// 协议(比如直接拖文件进浏览器)。必须通过 http://localhost:xxx
  • Unable to open fileFailed to open stream:PHP 内置服务器默认工作目录是命令执行位置,不是 VS Code 当前打开的文件夹。务必 cd 到项目根目录再运行 php -S
  • 修改代码后刷新没变化:PHP 内置服务器不自动热重载,改完保存后需手动刷新浏览器;如需实时响应,得换用 php -S + entr(Linux/macOS)或第三方工具如 Live Server(但该插件不支持 PHP 解析)

真正卡住人的往往不是语法,而是“不知道该让谁来执行这行 PHP”。内置服务器够用就别急着装 XAMPP;插件能省事就别反复 cd 和敲命令。端口冲突、PATH 没配好、误用 file:// 协议——这几个点反复确认一遍,90% 的“打不开”就解决了。


# php  # apache  # nginx  # 工具  # 路由  # vs code  # windows  # macos  # http  # linux  # router  # 的是  # 右键  # 报错  # 如需  # 打不开  # 可点  # 就别  # 需用  # 找不到  # 一遍 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: Win11摄像头无法使用怎么办_Win11相机隐私权限开启教程【详解】  如何用虚拟主机快速搭建网站?详细步骤解析  为什么php本地部署后css不生效_静态资源加载失败修复技巧【技巧】  ChatGPT 4.0官网入口地址 ChatGPT在线体验官网  Laravel Artisan命令怎么自定义_创建自己的Laravel命令行工具完全指南  Laravel如何设置自定义的日志文件名_Laravel根据日期或用户ID生成动态日志【技巧】  Laravel Eloquent关联是什么_Laravel模型一对一与一对多关系精讲  Laravel事件监听器怎么写_Laravel Event和Listener使用教程  Laravel集合Collection怎么用_Laravel集合常用函数详解  如何在阿里云ECS服务器部署织梦CMS网站?  Laravel如何创建自定义中间件?(Middleware代码示例)  Laravel如何生成PDF或Excel文件_Laravel文档导出工具与使用教程  太平洋网站制作公司,网络用语太平洋是什么意思?  大连企业网站制作公司,大连2025企业社保缴费网上缴费流程?  学生网站制作软件,一个12岁的学生写小说,应该去什么样的网站?  怎么用AI帮你设计一套个性化的手机App图标?  利用 Google AI 进行 YouTube 视频 SEO 描述优化  JS中对数组元素进行增删改移的方法总结  如何在VPS电脑上快速搭建网站?  Windows10怎样连接蓝牙设备_Windows10蓝牙连接步骤【教程】  Win10如何卸载预装Edge扩展_Win10卸载Edge扩展教程【方法】  Windows家庭版如何开启组策略(gpedit.msc)?(安装方法)  Laravel storage目录权限问题_Laravel文件写入权限设置  如何用AI一键生成爆款短视频文案?小红书AI文案写作指令【教程】  laravel怎么通过契约(Contracts)编程_laravel契约(Contracts)编程方法  Python并发异常传播_错误处理解析【教程】  如何登录建站主机?访问步骤全解析  如何获取PHP WAP自助建站系统源码?  香港服务器如何优化才能显著提升网站加载速度?  node.js报错:Cannot find module 'ejs'的解决办法  如何在 React 中条件性地遍历数组并渲染元素  邀请函制作网站有哪些,有没有做年会邀请函的网站啊?在线制作,模板很多的那种?  如何在沈阳梯子盘古建站优化SEO排名与功能模块?  使用C语言编写圣诞表白程序  ,南京靠谱的征婚网站?  深圳网站制作的公司有哪些,dido官方网站?  js实现点击每个li节点,都弹出其文本值及修改  Windows10电脑怎么设置虚拟光驱_Win10右键装载ISO镜像文件  Laravel怎么处理异常_Laravel自定义异常处理与错误页面教程  Angular 表单中正确绑定输入值以确保提交与验证正常工作  如何做网站制作流程,*游戏网站怎么搭建?  js实现获取鼠标当前的位置  Laravel策略(Policy)如何控制权限_Laravel Gates与Policies实现用户授权  魔方云NAT建站如何实现端口转发?  javascript如何操作浏览器历史记录_怎样实现无刷新导航  Swift中循环语句中的转移语句 break 和 continue  如何在 Pandas 中基于一列条件计算另一列的分组均值  如何在阿里云部署织梦网站?  高端建站三要素:定制模板、企业官网与响应式设计优化  Laravel如何升级到最新版本?(升级指南和步骤)