2026随心个人发卡网V2.0修复版用上传自己收款码.不需要支付接口.自动发卡密

个人发卡网平台-React+PHP7.4整合方案
不懂加QQ1469437475
##项目概述
这是一个个人发卡网平台的前后端分离解决方案，包含React前端应用和PHP7.4后端API。

##环境要求

###前端环境
-Node.js16+
-pnpm(推荐)或npm/yarn

###后端环境
-PHP7.4或更高版本
-SQLite3扩展
-Web服务器（如Apache、Nginx）

##安装与部署步骤

###1.前端安装与构建

```bash
#安装依赖
pnpminstall

#开发模式运行
pnpmdev

#构建生产版本
pnpmbuild
```

构建后的前端文件将位于`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代码中的APIURL，指向您的PHPAPI地址（在实际部署时）

##项目结构说明

###前端部分(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`:PHPAPI入口文件，处理所有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存储数据，部署时需要修改为使用PHPAPI

##常见问题解决

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

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

##部署到服务器

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