帝国CMS从MySQL 5.x迁移到MySQL 8.0全流程实操指南

前言

随着MySQL 5.7逐步停止支持，许多使用帝国CMS（EmpireCMS）的网站面临数据库升级需求。将帝国CMS从旧版MySQL（如5.5、5.6、5.7）迁移至MySQL 8.0，会因语法、默认配置和权限模型的差异，导致一系列兼容性问题。本文将提供一套完整、可直接复制的解决方案，确保迁移过程平滑无错。

迁移前的核心准备工作

在开始任何操作前，充分的准备是避免数据丢失的关键。

环境检查与备份

确认你的当前环境和新环境。登录到旧数据库服务器，执行以下命令：

``` mysql -u root -p SELECT VERSION(); ```

记录下当前的MySQL版本（例如：5.6.51）。接着，进行完整的数据备份，这包括数据库结构和内容。

``` 备份所有帝国CMS相关的数据库，假设数据库名为 ‘empirecms’ mysqldump -u root -p --databases empirecms --add-drop-database --complete-insert --default-character-set=utf8mb4 --result-file=empirecms_backup_$(date +%Y%m%d).sql ```

同时，备份帝国CMS的全部程序文件，特别是`/e/config/config.php`和`/e/class/`目录下的文件。

新环境预配置

在新的服务器或环境中安装MySQL 8.0。安装后，需要进行关键的兼容性配置。编辑MySQL配置文件`my.cnf`（通常位于`/etc/mysql/my.cnf`或`/etc/my.cnf`），在`[mysqld]`部分添加或修改以下参数：

``` [mysqld] 设置默认的认证插件为 mysql_native_password，兼容旧版PHP驱动 default_authentication_plugin=mysql_native_password 设置服务器默认字符集为 utf8mb4，支持完整的UTF-8（如表情符号） character-set-server=utf8mb4 collation-server=utf8mb4_unicode_ci 禁用 ONLY_FULL_GROUP_BY SQL模式，避免帝国CMS部分查询报错 sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION 设置默认存储引擎为 InnoDB default-storage-engine=INNODB ```

保存后重启MySQL服务使配置生效：

``` sudo systemctl restart mysql ```

数据迁移与导入的关键步骤

将备份的数据导入到MySQL 8.0前，必须先对SQL文件进行必要的预处理。

预处理备份的SQL文件

使用文本编辑器（如VS Code、Notepad++）打开备份的SQL文件，进行全局查找和替换：

• 将`TYPE=MyISAM`替换为`ENGINE=MyISAM`：MySQL 8.0已移除`TYPE`关键字。
• 检查并移除`sql_mode`相关设置：在文件顶部或底部，可能会包含类似`/!40101 SET @OLD_SQL_MODE=@@SQL_MODE /`的语句，这些可以保留，但确保我们已在服务器配置中统一设置了`sql_mode`。

如果你在旧版本中使用了`utf8`字符集，建议将其升级为`utf8mb4`。可以执行批量替换：

• 将`CHARSET=utf8`替换为`CHARSET=utf8mb4`
• 将`COLLATE utf8_general_ci`替换为`COLLATE utf8mb4_unicode_ci`

注意：替换前请确认原数据确实是utf8编码，且替换后需进行测试。

创建数据库并导入数据

登录MySQL 8.0，创建一个新的数据库，并指定字符集：

``` mysql -u root -p CREATE DATABASE empirecms_new CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ```

退出MySQL，使用以下命令导入预处理过的SQL文件：

``` mysql -u root -p empirecms_new < empirecms_backup_processed.sql ```

程序文件与配置的适配修改

数据导入后，需要修改帝国CMS的程序文件以适配MySQL 8.0。

修改数据库连接驱动

帝国CMS默认使用`mysql`扩展，该扩展在PHP 7.0后已被移除。如果你的PHP版本>=7.0，必须切换到`mysqli`。

找到并编辑帝国CMS的数据库配置文件`/e/config/config.php`（路径可能因安装略有不同）。

找到类似以下的行：

``` $ecms_config['db']['usedb']='mysql'; //数据库类型 ```

将其修改为：

``` $ecms_config['db']['usedb']='mysqli'; //数据库类型 ```

修复已知的SQL语法不兼容问题

帝国CMS的部分代码中，使用了MySQL 8.0中已移除或严格限制的语法。

问题1：GROUP BY 子句的严格性

MySQL 8.0默认启用了`ONLY_FULL_GROUP_BY`模式。虽然我们在`my.cnf`中已全局禁用它，但为了代码健壮性，建议修复相关查询。常见的报错位置在`/e/class/`下的文件。例如，在`/e/class/t_functions.php`中搜索`GROUP BY`，检查查询语句中的SELECT字段是否都包含在GROUP BY子句中或使用了聚合函数。如果不便修改所有代码，依赖全局`sql_mode`设置是可行的临时方案。

问题2：用户权限管理语句

如果你在帝国CMS后台或自定义代码中执行了创建用户的SQL命令，语法已变更。

旧版语法（5.7）：

``` GRANT ALL PRIVILEGES ON . TO 'username'@'localhost' IDENTIFIED BY 'password'; ```

MySQL 8.0 语法：

``` CREATE USER 'username'@'localhost' IDENTIFIED BY 'password'; GRANT ALL PRIVILEGES ON . TO 'username'@'localhost'; FLUSH PRIVILEGES; ```

验证数据库连接与基本功能

将修改后的帝国CMS程序文件部署到新服务器（或修改本地环境配置）。更新`/e/config/config.php`中的数据库连接信息，指向新的MySQL 8.0数据库：

``` $ecms_config['db']['dbusername']='root'; //数据库用户名 $ecms_config['db']['dbpassword']='your_new_password'; //数据库密码 $ecms_config['db']['dbname']='empirecms_new'; //数据库名 $ecms_config['db']['dbserver']='localhost'; //数据库服务器地址，根据实际情况修改 ```

打开浏览器访问网站首页和后台（`/e/admin`）。如果能正常打开且无数据库错误提示，说明连接成功。

迁移后的全面测试清单

连接成功只是第一步，必须进行全方位测试以确保所有功能正常。

• 后台登录：使用管理员账号登录后台，检查是否成功。
• 栏目与内容管理：尝试添加一个新栏目，发布一篇新文章（包含文字和图片），然后编辑、删除该文章。
• 数据检索：使用前台的搜索功能，测试是否能正常返回结果。
• 会员功能：如果网站开启了会员系统，测试会员注册、登录、发布信息等功能。
• 标签调用：检查首页和各栏目页的动态标签（如最新信息、热门信息）是否正常显示。
• 生成静态页：在后台执行“刷新首页”、“刷新栏目信息页”等操作，检查静态文件是否成功生成且内容正确。

在测试过程中，务必打开PHP的错误日志（查看`php.ini`中`error_log`配置的路径），任何警告或错误都需记录下来并逐一解决。

常见问题与即时解决方案

以下是在迁移过程中可能遇到的典型错误及解决方法。

错误：Client does not support authentication protocol...

这是由于MySQL 8.0使用了新的`caching_sha2_password`认证插件，而旧版PHP驱动不支持。

解决方案：我们已经通过配置`default_authentication_plugin=mysql_native_password`解决了服务器默认问题。如果为特定用户创建了账户，也需要修改其插件：

``` ALTER USER 'empirecms_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; FLUSH PRIVILEGES; ```

错误：In aggregated query without GROUP BY, expression 1 contains nonaggregated column...

这是`ONLY_FULL_GROUP_BY` SQL模式导致的。

解决方案：首先确认`my.cnf`中`sql_mode`的修改已生效。登录MySQL执行：

``` SELECT @@GLOBAL.sql_mode; ```

确保返回结果中没有`ONLY_FULL_GROUP_BY`。如果仍有问题，可以在帝国CMS连接初始化后立即执行一个SQL语句来设置会话模式。在连接数据库的公共文件（如`/e/class/connect.php`）中，找到连接成功后的位置，添加：

``` // 假设$link为数据库连接对象（mysqli） mysqli_query($link, "SET SESSION sql_mode='STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION'"); ```

网站部分页面乱码

这通常是表或字段的字符集与连接字符集不一致导致。

解决方案：确保MySQL 8.0的数据库、表、字段都是`utf8mb4`。可以抽查几个关键表：

``` SHOW CREATE TABLE phome_ecms_news; ```

确保PHP连接数据库时也指定了字符集。在帝国CMS的数据库连接初始化代码中（通常在`/e/class/db_sql.php`或类似文件），找到执行连接后的语句，添加：

``` mysqli_set_charset($this->link, 'utf8mb4'); ```

最终收尾与优化建议

当所有测试通过后，进行以下收尾工作：

1. 正式切换：将域名解析指向新服务器，或正式启用新环境。
2. 监控：迁移后密切监控网站错误日志和MySQL慢查询日志至少一周。
3. 性能考虑：MySQL 8.0性能提升显著，但部分查询可能需要因优化器变更而调整索引。使用`EXPLAIN`分析关键页面的慢查询，必要时优化索引。
4. 备份新环境：在一切稳定后，对新的“帝国CMS + MySQL 8.0”环境做一次完整的全量备份，作为新的基准。

至此，帝国CMS到MySQL 8.0的迁移全部完成。整个过程的核心在于预处理SQL文件、正确配置MySQL 8.0的兼容性参数以及细致的功能验证。按照上述步骤操作，可以最大程度避免未知错误，实现平稳升级。