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

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 file 或 Failed to open stream：PHP 内置服务器默认工作目录是命令执行位置，不是 VS Code 当前打开的文件夹。务必 cd 到项目根目录再运行 php -S
• 修改代码后刷新没变化：PHP 内置服务器不自动热重载，改完保存后需手动刷新浏览器；如需实时响应，得换用 php -S + entr（Linux/macOS）或第三方工具如 Live Server（但该插件不支持 PHP 解析）

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