系统搭建
以下环境为 Linux 生产部署要求（已在 PHP 8.2 + MySQL 8.0 环境验证通过）。
软件环境
| 软件 | 版本 | 必选 | 说明 |
|---|---|---|---|
| PHP | 8.2.x | ✅ | ThinkPHP 8 框架要求，Web 方式需 PHP-FPM |
| MySQL | 8.0 | ✅ | InnoDB + utf8mb4，表前缀 sp_；初始化脚本 api/database/sparkshop_ordering.sql（86 张表） |
| Nginx | 1.20+ | ✅ | 单域名部署：/backend 平台后台、/cashier 收银台、/h5 商城，其余请求走 TP8 入口 |
| Supervisor | 4.x | ✅ | 守护执行 php think 定时任务调度（见下文「定时任务」） |
| Redis | 6.x / 7.x | ⭕ 推荐 | 需 PHP redis（phpredis）扩展；用于缓存、秒杀库存、分布式锁；连接失败时业务自动降级，不阻断安装与运行 |
PHP 扩展
- 必需：
pdo_mysql、curl、gd、fileinfo、mbstring、openssl、bcmath、zip - 推荐：
redis（phpredis，秒杀/缓存高并发优化；缺失仅告警不阻断）
新建站点
比如域名是 www.shop.com 同时选择 php 的版本是 8.2
上传文件
将源码中的 api 目录压缩整个传上去，并解压
配置网站
网站目录选择你设置的网站，运行目录选择到 public 下
设置好伪静态
打开配置文件，设置好转发路由
location /backend {
try_files $uri $uri/ /backend/index.html;
}
location /cashier {
try_files $uri $uri/ /cashier/index.html;
}
配置ssl证书
新建数据库
记住你的用户名和密码
配置定时任务
目录选择网站的目录，命令行是
php think crontab:run
访问下一步即可完成
总后台 你的域名/backend
收银台 你的域名/cashier