升级指南

升级时使用带版本号和 SHA-256 校验值的完整发行包，不要直接下载来源不明的零散文件，也不要单独替换框架目录。

升级前

1. 确认当前 PHP 版本满足发行包要求。
2. 备份数据库和站点代码，并确认备份文件可读取。
3. 核对安装包 SHA-256 与下载页公布的值完全一致。
4. 确认 config/config.php、storage/、public/uploads/ 和自定义主题属于站点实例数据，不应被核心更新覆盖。

预检

php bin/cms.php upgrade /path/to/cms-x.y.z.tar.gz --dry-run

预检会检查 PHP、数据库、目录权限、版本关系、发行清单和待覆盖核心文件。任何一项失败都会明确退出，不会继续切换代码。

执行升级

php bin/cms.php upgrade /path/to/cms-x.y.z.tar.gz

升级器会依次完成数据库备份、临时目录解包、PHP 语法检查、核心文件切换、编号迁移、缓存清理和独立进程健康检查。成功后再检查：

php bin/cms.php versionphp bin/cms.php migrate:statusphp bin/cms.php manifest:verifyphp bin/cms.php health

实例数据边界

核心升级不会覆盖以下内容：

• config/config.php
• storage/ 中的数据库、日志、备份、缓存和运行数据
• public/uploads/
• 除默认主题以外的站点主题
• 站点自己的插件与配置

数据库迁移不承诺自动反向执行，因此生产升级前仍需要服务器快照或可验证的数据库备份。