VSCode配置PHP环境教程：零基础也能轻松运行PHP项目

作为计算机小白，想用VSCode运行PHP项目却不知从何下手？别担心！这篇教程将用最通俗易懂的方式，手把手教你完成PHP环境配置和项目运行。无需任何编程基础，跟着做就能成功！

一、准备工作：安装必要软件

1. 安装Visual Studio Code（VSCode）

▶ 下载地址：VSCode官网
▶ 安装步骤：

1. 双击下载的安装包（Windows选.exe，Mac选.dmg）
2. 全部保持默认选项，一路点击"Next"直到完成
3. 安装完成后打开VSCode

2. 安装PHP运行环境

▶ Windows用户：

1. 下载PHP：Windows版PHP下载

   • 选择最新"Thread Safe"版本的ZIP包
     

2. 新建php文件夹，将ZIP包解压到自己新建的文件夹里，复制文件地址
   

3. 配置环境变量：

   • 右键"此电脑" → 属性 → 高级系统设置 → 环境变量
   • 在"系统变量"中找到Path → 编辑 → 新建 → 输入D:\APP\PHP
   • 确定保存所有窗口

▶ Mac用户：

打开终端（应用程序→实用工具→终端），粘贴以下命令：

brew install php

▶ 验证安装：

1. 打开命令提示符（Windows）或终端（Mac）
2. 输入命令：

php -v

如果显示PHP版本信息（如PHP 8.2.5），说明安装成功！

二、配置VSCode运行PHP项目

1. 打开项目文件夹

1. 解压你获得的PHP项目压缩包
2. 在VSCode中点击：
   文件(File) → 打开文件夹(Open Folder) → 选择项目文件夹

2. 安装必要扩展（插件）

在VSCode左侧活动栏点击扩展图标（或按Ctrl+Shift+X），搜索安装：

1. PHP Intelephense（PHP代码支持）
2. PHP Server（一键启动服务器）

三、两种方式运行PHP项目

方法1：使用终端命令（推荐）

1. 在VSCode中打开终端：
   终端(Terminal) → 新建终端(New Terminal)（快捷键Ctrl+`）
2. 输入以下命令启动服务器：

php -S localhost:8000

3. 终端会显示：

PHP 8.2.5 Development Server started at http://localhost:8000

4. 按Ctrl+点击这个链接，或在浏览器输入：
   http://localhost:8000
   

方法2：使用PHP Server插件（更简单）

1. 在VSCode左侧资源管理器
2. 右键点击index.html文件
3. 选择PHP Server: Serve project
4. 浏览器会自动打开项目页面

四、常见问题解决方案

问题1：PHP不是内部或外部命令

→ 说明PHP环境变量未配置成功，请重新检查第一部分第2步

问题2：访问页面显示404错误

→ 确保：

1. 终端是在项目根目录运行的（路径包含api.php）
2. 启动服务器后不要关闭终端窗口

问题3：数据库连接失败

1. 检查项目中的db/data.db文件是否存在
2. 右键该文件 → 属性 → 取消"只读"勾选

五、项目结构说明

ZUANBIOT.COM-MASTER/
├── css/            # 样式文件
├── db/             # 数据库文件
│   └── data.db     # SQLite数据库
├── js/             # JavaScript文件
├── images/         # 图片资源
├── api.php         # PHP后端接口
└── index.html      # 前端页面