升级
本文说明 Bring 外贸扩展与 EspoCRM 的升级步骤与注意事项。
参考 Espo：Upgrading、Extensions
升级前
- 备份（必做）
- 专业版：管理 → Bring外贸 → 数据备份与恢复 → 手动备份
- 整站：Docker 环境执行
backup-docker-container.sh，或 Espo 管理 → 备份与恢复 - 记录当前版本：管理 → 升级 或扩展信息页
- 阅读新版本发布说明（如有数据库结构变更）
升级 Bring 扩展
- 从官网下载新版 ForeignTrade zip
- 管理 → 扩展
- 若已安装旧版：先 卸载 旧扩展（可选，视发布说明；多数情况直接上传覆盖安装）
- 上传新 zip → 安装
- 执行 Rebuild：
- 管理界面点击 Rebuild，或
- Docker：
docker exec bringcrm php rebuild.php - 清除缓存，浏览器强制刷新
升级保护
新版 AfterInstall 对已有站点不会覆盖：角色权限、PDF/Excel/导入模板、导航 tab 顺序、货币列表等您已修改的配置（仅补缺失项）。
升级 EspoCRM 核心
- 按 Espo 官方升级文档 操作
- Bring 扩展要求 Espo 9.1+（以安装页说明为准）
- 核心升级后务必再次 Rebuild
Docker 环境
- 备份数据卷与数据库
- 更新
docker-compose.yml中espocrm/espocrm镜像 tag（若需升级 Espo 版本） docker compose pull && docker compose up -d- 进入容器执行升级脚本/
php rebuild.php（视 Espo 升级方式）
升级后验证
- [ ] 能登录，首页无 500 错误
- [ ] 外贸菜单完整
- [ ] 打开报价单/销售单详情正常
- [ ] 打印 PDF 正常
- [ ] 专业版许可仍有效（管理 → Bring外贸专业版许可）
- [ ] Cron/daemon 容器运行中（邮件、定时备份）
回滚
- 恢复升级前备份 zip 或 Docker 备份包
- Bring 业务恢复见 数据备份与恢复
常见问题
升级后菜单英文或缺失
- Rebuild + 清除缓存；确认 lang-zh 与 ForeignTrade 均已启用
模板被覆盖？
- 新版安装逻辑应跳过已有模板；若被覆盖可从备份 zip 恢复 Excel/导入模板