个人发卡网平台 – React + PHP7.4 整合方案

不懂加QQ1469437475

项目概述

这是一个个人发卡网平台的前后端分离解决方案，包含React前端应用和PHP7.4后端API。

环境要求

前端环境

• Node.js 16+
• pnpm (推荐) 或 npm/yarn

后端环境

• PHP 7.4 或更高版本
• SQLite3 扩展
• Web服务器（如Apache、Nginx）

安装与部署步骤

1. 前端安装与构建

# 安装依赖
pnpm install

# 开发模式运行
pnpm dev

# 构建生产版本
pnpm build

构建后的前端文件将位于dist目录。

2. PHP后端部署

1. 将php-api目录中的所有文件复制到您的PHP服务器的Web根目录或子目录
2. 确保PHP有写权限来创建和修改app.db文件
3. 测试API是否正常工作：
   • 访问http://your-server/php-api/index.php/content
   • 访问http://your-server/php-api/index.php/products

3. 整合前后端

1. 前端构建完成后，将dist目录中的所有文件复制到PHP服务器的Web目录
2. 修改React代码中的API URL，指向您的PHP API地址（在实际部署时）

项目结构说明

前端部分 (React)

• src/App.tsx: 主应用组件
• src/pages/: 页面组件
  • Home.tsx: 首页
  • SelfOrderingPage.tsx: 自助下单页面
  • AdminPage.tsx: 后台管理页面
• src/components/: 通用组件
• src/contexts/: React上下文，用于状态管理
• src/hooks/: 自定义React钩子

后端部分 (PHP)

• php-api/index.php: PHP API入口文件，处理所有API请求
• php-api/app.db: SQLite数据库文件（自动创建）

使用说明

前端功能

1. 首页：显示欢迎信息和下单入口
2. 自助下单：选择商品、数量，输入QQ邮箱，进行支付
3. 订单查询：通过QQ邮箱查询已完成订单和卡密信息
4. 后台管理：
   • 内容管理：配置页面标题、按钮文字、收款码等
   • 商品管理：添加/编辑/删除商品分类和商品
   • 订单管理：处理用户订单，分配卡密
   • 安全设置：修改管理员账号密码

后端API

• /content: 获取前端配置内容
• /products: 获取商品分类和商品信息
• /orders: 订单管理（创建、查询）
• /auth: 管理员认证

注意事项

1. 在生产环境中，请务必修改默认的管理员账号和密码
2. 定期备份app.db数据库文件以防数据丢失
3. 对于大型应用，建议考虑使用更强大的数据库系统如MySQL
4. 前端应用在开发模式下使用localStorage存储数据，部署时需要修改为使用PHP API

常见问题解决

前端问题

• 无法访问页面：检查Node.js版本和依赖安装是否正确
• 功能异常：查看浏览器控制台的错误信息

后端问题

• API返回404：检查URL路径和服务器配置
• 数据库错误：确保PHP有正确的文件权限
• 跨域问题：检查CORS配置

部署到服务器

1. 在服务器上安装必要的环境（PHP、Web服务器）
2. 部署PHP API到服务器
3. 构建React前端应用并部署到服务器
4. 配置Web服务器（Apache/Nginx）指向前端构建目录
5. 设置适当的文件权限
6. 测试整个系统是否正常工作

点击下载