海洋 CMS 如何升级系统程序版本

海洋CMS 升级系统程序版本的标准流程是：**先完整备份数据库和网站目录 → 核对升级包的适用版本 → 用官方升级包覆盖程序文件（保留 data/、uploads/、template/）→ 执行升级脚本 → 清缓存并逐项回归测试**。跳过备份、或者把整站目录直接解压覆盖，是升级后白屏、播放地址失效、后台登录不进去的最主要原因。

升级前必须备份哪些内容？

结论：升级前必须做两件事——数据库全量导出 + 网站根目录打包压缩，缺一不可。

数据库导出命令（在服务器 SSH 里执行）：

mysqldump -u 数据库用户名 -p 数据库名 > seacms_20240601.sql

注意只导海洋CMS 自己那个库，不要用 --all-databases；如果表前缀被改过，导出的就是同一份数据，不用额外处理。网站目录打包：

tar -czf seacms_site_20240601.tar.gz /www/wwwroot/你的站点目录

data/common.inc.php（数据库连接配置文件）和 uploads/（附件、图片、播放器文件）都在这份压缩包里，这是升级失败后唯一能一键回滚的东西。备份文件不要放在网站根目录下，否则等于对外开放下载。导出完成后看一眼文件大小，0 字节说明导出失败，必须重做。

海洋CMS 能跨大版本直接升级吗？

结论：不能。海洋CMS 的升级包按版本递增发布，只能逐级升级，不能从早期版本一步跳到最新版。

原因是升级包里除了程序文件，还包含数据库结构变更脚本（新增字段、修改表结构、迁移旧数据）。跨多个版本覆盖时，脚本找不到它预期的旧表结构，会在执行中途报错，留下一个“半升级”状态的数据库，比不升级更难修。

实际操作方法：在后台首页或官方发布页记录当前版本号，然后按官方升级说明里标注的“适用版本”，从当前版本往上逐个套用升级包。比如当前是 A 版、目标是 C 版，就先升到 B 再升到 C。

手动覆盖升级的具体步骤？

结论：手动升级分五步，顺序不能调换。

1. 关站并备份：先执行上文的数据库导出和目录打包。
2. 记录版本号：截图后台首页的版本信息，升级出问题时这是唯一的对照依据。
3. 上传升级包：把官方升级包解压后，将里面的程序文件覆盖到站点根目录。不要覆盖 data/、uploads/、template/ 这三个目录——前者存配置和缓存，中间存会员上传的附件，后者存你自己改过的模板。
4. 执行升级脚本：按官方升级说明访问指定地址（常见形式是 http://你的域名/upgrade/ 或某个升级 php 文件），页面提示“升级成功”才算完成。
5. 收尾三件事：删除 install/、upgrade/ 目录防止被扫描利用；后台执行一次“更新缓存”；检查 data/、uploads/ 目录权限为 755、文件 644，属主是 Web 运行用户（通常是 www 或 nginx）。

后台自带的在线升级怎么用？

结论：部分海洋CMS 版本在后台“系统”菜单下提供在线升级入口，点击后由程序自动下载并覆盖文件，适合版本跨度小、服务器能访问外网的场景。

使用前提有两个：一是 PHP 的 allow_url_fopen 或 curl 扩展可用，二是网站目录对 Web 用户可写。在线升级同样要先备份数据库——它只自动备份程序文件，不会替你导数据。升级过程中不要刷新页面或关浏览器，中断会留下不完整的文件。

升级后白屏、模板错乱、播放失效怎么排查？

结论：按“PHP 版本 → 目录权限 → 模板文件 → 缓存”这个顺序查，四步能覆盖九成问题。

• 白屏：先开启 PHP 错误显示，查看站点 error_log 最后几行。旧版海洋CMS 在 PHP 5.x 上跑得好好的，搬到 PHP 7.x/8.x 后大量函数被移除，会直接白屏；把 PHP 切回官方要求的版本即可。
• 模板错乱：说明升级包覆盖了 template/ 下的自定义模板。用备份里的模板目录还原，再对照新版默认模板补齐新增的标签调用。
• 播放地址/采集失效：进入后台更新缓存，再检查播放器相关文件是否被新版替换。
• 后台登录失效：多为 data/ 缓存文件残留旧结构，删除 data/ 下的缓存文件（保留 common.inc.php）后重新登录。

升级完成后，至少回归测试四项：前台首页、视频详情页播放、后台登录、一次采集或发布操作。四项都通过，才算升级成功。