升级指南

升级方式

系统支持通过本地升级包进行版本升级。你需要从官方获取对应版本的 ZIP 升级包，上传到服务器后由系统自动完成升级。

注意

系统不支持在线自动下载更新，需要手动将升级包上传到服务器。

升级步骤

1. 备份数据

升级前必须做好备份：

• 备份数据库（通过 phpMyAdmin 或命令行导出）
• 备份 .env 配置文件

2. 上传升级包

将获取到的升级包（如 v1.1.0.zip）上传到项目根目录（与 app/、public/ 同级）：

your-domain/
├── app/
├── public/
├── v1.1.0.zip    ← 升级包放在这里
└── ...

多版本升级

如果需要跨多个版本升级（如 v1.0.0 → v1.2.0），请将中间版本的升级包一并上传（v1.1.0.zip、v1.2.0.zip），系统会按版本号从低到高依次执行升级。

3. 执行升级

1. 登录后台，系统会自动检测到根目录下的升级包
2. 弹出升级提示对话框，显示待升级的版本号
3. 点击 确认升级，系统自动执行以下操作：
   • 解压升级包到临时目录
   • 执行数据库迁移 SQL（如有）
   • 覆盖更新的程序文件
   • 更新系统版本号
   • 清理临时文件和旧版本资源
4. 升级完成后页面会自动刷新

4. 验证升级

升级完成后，检查以下内容：

• 系统版本号是否已更新
• 各功能模块是否正常运行
• 数据是否完整

升级前注意事项

事项	说明
备份数据库	必须在升级前备份
备份 .env	包含数据库密码等关键配置
低峰期操作	避免在业务高峰期升级
测试环境先行	有条件的话先在测试环境验证
升级包来源	仅使用官方提供的升级包

下一步

• 部署问题 FAQ → 升级相关常见问题
• 环境要求 → 确认服务器环境是否满足新版本要求