苹果CMS旧版本通用全流程修复不踩坑可回滚升级实操指南

一、升级前强制准备（缺一不可，防止数据全丢）

1.1 核心数据双备份

本地服务器/宝塔面板操作通用，步骤如下：

• 文件备份：压缩整个苹果CMS根目录（注意跳过runtime/temp、runtime/logs这类临时目录，速度快50%+），保存到本地电脑或云存储的非网站根目录位置。
• 数据库备份： 宝塔面板：进入「数据库」找到对应苹果CMS数据库，点击右侧「备份」，下载最新备份文件到本地； 其他面板/本地phpMyAdmin：登录后选中数据库，点击「导出」，格式选SQL，「压缩」选zip/gzip，导出后保存。

1.2 检查环境是否满足要求

苹果CMS最新稳定版（截至202X.X.X通用主流版）要求：PHP≥7.2（推荐PHP7.4/8.0性能稳定）、MySQL≥5.5（推荐5.7/8.0）、支持伪静态、fileinfo扩展、openssl扩展。

• 宝塔面板检查：进入「软件商店」-「已安装」找到对应PHP版本，点击「设置」-「扩展」，确认fileinfo、openssl已安装并开启，未开启的点击「安装」；再点击「性能调整」确认版本≥7.2。
• 本地环境/phpinfo检查：创建test.php文件，输入，上传到网站根目录访问，搜索上述环境参数是否满足。

1.3 获取最新稳定版安装包

官方唯一指定安全下载地址：https://www.maccms.org/down.html，选择「苹果CMSX正式版」（不管旧版是V10/V8，最新通用X版向下兼容修复版旧数据），下载后解压缩到本地备用。

二、无数据覆盖上传（关键可回滚步骤）

重点：只上传替换新增/修改的文件，保留data、template、runtime、uploads、user、config这6个核心目录（runtime目录可清空temp、logs，其他保留）

• 宝塔面板操作： 1. 进入「文件」找到苹果CMS根目录，备份或删除非保留目录里的旧文件； 2. 点击「上传」，将本地解压缩后的苹果CMSX正式版文件（除刚才的6个核心目录外）全选上传； 3. 上传完成后检查：application、extend、public这三个目录是否完整更新。
• FTP工具操作： 1. 使用FileZilla（免费安全下载：https://filezilla-project.org/download.php?type=client）连接网站； 2. 本地解压缩目录和远程网站根目录同时打开，删除远程非保留目录的旧文件； 3. 将本地解压缩后的非保留目录及根目录下的单个文件（如index.php、admin.php、api.php等）全选，选择「覆盖所有旧文件」上传。

三、升级数据库与修复核心权限

3.1 升级数据库

1. 访问苹果CMS后台升级入口：你的网站域名/install/update.php； 2. 系统会自动检测旧版本，选择「我已备份，开始升级」； 3. 等待进度条走完，出现「升级成功，请删除install目录」提示； 4. 立即按提示删除根目录下的整个install目录（宝塔/FTP都可以）。

3.2 修复核心目录权限

升级后必须修复权限，否则会出现无法上传、生成缓存等问题，通用权限设置： 宝塔面板：进入「文件」找到苹果CMS根目录，全选保留的6个核心目录（data、template、runtime、uploads、user、config），点击「权限」，设置为755（文件夹）和644（文件），勾选「应用到子目录」； FTP工具：右键选中目录，选择「属性/权限」，数字填755，勾选「递归到子目录」。

四、清理旧缓存与修复旧版插件/模板

4.1 清理所有旧缓存

1. 登录升级后的苹果CMS后台（原账号密码不变）； 2. 进入左侧菜单「系统」-「清除缓存」，全选所有缓存项（包括模板缓存、数据缓存、路由缓存等），点击「清除」； 3. 清空浏览器缓存（Ctrl+Shift+Delete）后重新访问前台，确认页面正常显示。

4.2 旧版插件修复

如果旧版用了第三方插件，按以下步骤操作： 1. 先禁用所有旧插件（后台「应用」-「插件管理」全选禁用）； 2. 访问官方插件市场（后台「应用」-「插件市场」）下载对应苹果CMSX版的插件； 3. 安装并启用后，重新配置旧参数（部分插件会自动导入部分旧数据）； 4. 若官方没有对应插件，联系插件作者获取X版适配包，或暂时不使用该插件。

4.3 旧版模板修复

通用旧模板适配修复步骤： 1. 检查模板目录下的index.php、header.php、footer.php等核心文件，删除顶部的“防版权混淆代码”（苹果CMSX版已修复该问题）； 2. 将模板文件中所有的{$maccms.path}替换为{$Think.ROOT_PATH}，{$maccms.httpurl}替换为{$Request.domain}； 3. 进入后台「系统」-「网站参数」-「模板设置」，确认当前模板为旧模板，点击「保存」； 4. 再次清除所有缓存，重新访问前台，检查页面元素是否正常。

五、可回滚操作方案（如果升级出问题）

1. 删除当前网站根目录的所有文件； 2. 上传升级前备份的根目录压缩包，解压缩到原位置； 3. 进入宝塔数据库/本地phpMyAdmin，删除当前数据库的所有表，导入升级前的SQL备份文件； 4. 修复核心目录权限（同3.2步骤），清理浏览器缓存，网站即可恢复到升级前状态。