LECMS怎么升级到最新版本

学完这篇，你能安全地把手里的 LECMS 从旧版本升到官方最新版，且不丢数据、不丢自己改过的模板。

第一步：先确认你现在是哪个版本

升级前必须知道起点，否则后面不知道该覆盖哪些文件。登录后台，默认入口是 你的域名/admin.php，输入管理员账号密码后进入首页，页面右下角或「系统」→「系统信息」里会显示当前版本号，例如 LECMS 3.0.8。

如果后台进不去，直接在服务器上打开网站根目录下的 version.php（部分版本是 data/version.php），里面的 'version' 字段就是版本号。

记下这个数字，后面每一步都要对比。

第二步：做一次完整备份（这步不能省）

LECMS 升级是覆盖式升级，出错就只能靠备份回滚。需要备份两样东西：

1. 数据库：宝塔面板 →「数据库」→ 找到 LECMS 对应的库 → 点「备份」；或用命令行 mysqldump -u用户名 -p 数据库名 > /root/lecms_$(date +%F).sql。
2. 整站文件：把网站根目录整个打包，命令 tar -zcvf /root/lecms_site_$(date +%F).tar.gz /www/wwwroot/你的站点目录。

注意：只备份数据库不备份文件，等于没备份。LECMS 的 config/database.php 和 data/ 目录里存着配置和缓存，覆盖丢了两样都恢复不了。

第三步：下载官方最新版安装包

去 LECMS 官网的下载页，或者你购买授权时拿到的会员中心，下载最新完整版安装包（不是「补丁包」的话下面步骤通用）。下载完在本地解压，先别上传。

打开解压后的 version.php，确认版本号确实比你当前的高。如果跨了大版本（比如 2.x 升 3.x），先去官网看有没有单独的「升级说明」文档，跨大版本通常要额外执行数据结构变更脚本。

第四步：上传并覆盖文件，但把这些目录排除掉

用 FTP 或宝塔「文件」管理器，把新版文件上传到网站根目录，选择「覆盖同名文件」。

覆盖时必须保留以下内容，不要被新包里的同名文件替换：

• config/database.php（数据库连接信息）
• data/ 整个目录（配置缓存、附件索引）
• uploads/ 或 public/uploads/（用户上传的图片附件）
• application/ 下你自己改过的模板和控制器（如果你做过二次开发）
• 你自定义的模板目录，通常在 template/ 下

注意：宝塔上传时如果直接解压整包，会把 install/ 一起覆盖。安装目录里可能有 install.lock，覆盖后务必确认这个锁文件还在，否则别人能重新跑安装程序。

第五步：执行升级脚本

新版文件覆盖完成后，访问 你的域名/install/upgrade.php（部分版本是 你的域名/upgrade.php）。页面会提示「检测到当前版本 X.X.X，可升级到 X.X.X」，点「开始升级」。

升级过程会执行数据库表结构变更和数据迁移，通常几秒到几分钟。期间不要刷新页面、不要关浏览器。看到「升级成功」提示后，立刻删除或重命名 install 目录。

第六步：清缓存并验证

进入后台，「系统」→「更新缓存」→ 勾选全部选项 → 提交。然后：

1. 回后台首页看版本号是否已经变成最新版。
2. 打开前台首页、栏目页、内容详情页各看一遍。
3. 登录后台，发一篇测试文章，再删掉。

任何一步报错，就把第二步的备份还原回去，重新检查是哪个文件覆盖错了。

小结

• 升级顺序固定：查版本 → 备份数据库和整站文件 → 下载新版 → 覆盖时排除 config、data、uploads、自定义模板 → 跑 upgrade.php → 清缓存 → 删 install。
• 最容易翻车的是「只备份数据库」和「把 data 目录覆盖掉」，这两点守住基本不会出事。
• 跨大版本升级先看官方说明，必要时先在本地或测试环境跑一遍再动正式站。