从 v3 升级至 v4 教程

简介

v4 版本引入了队列执行任务机制，大幅提升了资源利用效率并增强了高并发能力。

1. 升级前的准备工作

请导出数据库，存为 apple.sql 文件。

推荐部署方式：Docker Compose

2. 卸载旧版本后端

请执行以下命令以停止并移除旧版本容器：

docker stop appleautopro
docker rm appleautopro
docker ps -a | grep 'apple-auto' | awk '{print $1}' | xargs docker rm -f

3. 部署新版本

使用 Docker Compose 部署

1. 完成 Docker Compose 安装及配置
   请参考 Docker Compose 部署文档 中的 "5.启动服务" 及之前的步骤。

2. 恢复数据库

   • 将数据库备份文件 (apple.sql) 移至项目根目录。
   • 执行以下命令导入数据库（请根据 .env 文件获取数据库 Root 密码）：

   docker compose cp apple.sql mariadb:/tmp
   docker compose exec -it mariadb mariadb -uroot -p<数据库Root密码>

3. 在 MariaDB 容器中重建数据库

   DROP DATABASE appleautopro;
   CREATE DATABASE appleautopro;
   USE appleautopro;
   SOURCE /tmp/apple.sql;

若操作无报错，请执行 exit 退出容器。

4. 重启服务

   docker compose down && docker compose up -d

5. 验证数据与功能
   使用原有账户登录并确认数据是否正常。如无问题，可删除旧版数据库及网页文件。

---

手动部署

1. 前端安装
   • 请根据 前端安装文档 完成 1~6 步骤。
   • 注意：请将 PHP 版本调整为 8.x。
2. 系统配置检查
   • 前端安装完成后，请登录管理面板确认系统配置是否正确。
3. 后端安装
   • 请参考 后端安装文档 完成后端配置。

---

🎉 升级完成

现在，您已成功完成从 v3 到 v4 的升级！