OpenCart 重装后把数据库编码从 utf8 改成 utf8mb4 全过程指南

donzhtm

OpenCart 重装后把数据库编码从 utf8 改成 utf8mb4 全过程指南

这份文档适用于 OpenCart 3.x 版本使用 MySQL 5.7 或高版本数据库的环境，目标是确保支持 Emoji 和其他 4 字节 Unicode 字符，采用 utf8mb4 编码。

---

一、初始化数据库时，选择 utf8mb4
在新建 OpenCart 系统时，创建数据库时：

• 精确选择编码为 utf8mb4_general_ci
• 如果是用 phpMyAdmin，在创建数据库时输入：
  

数据库名称: dataname007
编码: utf8mb4_general_ci

---

二、检查补教数据库表的字符集
使用 phpMyAdmin 或线上执行：
SELECT TABLE_NAME, CCSA.character_set_name AS charset
FROM information_schema.`TABLES` T,     
           information_schema.`COLLATION_CHARACTER_SET_APPLICABILITY` CCSA
WHERE CCSA.collation_name = T.table_collation  
AND T.table_schema = 'dataname007';
查看是否都是 utf8mb4 系列

---

三、修改表和列为 utf8mb4
假设表为 oc_category_description，如果列是 utf8，需要执行：
ALTER TABLE oc_category_description CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
如果需要修改有索引的 varchar 类型，可选择将 255 改为 191：
ALTER TABLE oc_category_description
MODIFY name VARCHAR(191) NOT NULL,
MODIFY header VARCHAR(191) NOT NULL,
MODIFY meta_title VARCHAR(191) NOT NULL,
MODIFY meta_description VARCHAR(191) NOT NULL,
MODIFY meta_keyword VARCHAR(191) NOT NULL;

---

四、确保 MySQL 配置支持 utf8mb4
打开 /etc/my.cnf或 /etc/mysql/my.cnf，确保有：
[client]
default-character-set = utf8mb4

[mysql]
default-character-set = utf8mb4
[mysqld]character-set-server = utf8mb4
collation-server = utf8mb4_general_ci
重启 MySQL 生效：
sudo systemctl restart mysql

---

五、修改 PHP 数据库连接编码
打开：system/library/db/mysqli.php
找到：
$this->connection->set_charset('utf8');
改为：
$this->connection->set_charset('utf8mb4');
确保 OpenCart 和 MySQL 连接时使用 utf8mb4

---

六、Twig 模板文本输出使用 |raw
修改：
{{ description }}
成：
{{ description|raw }}
确保能正确输出 Emoji 和 HTML 标签

---

结论
一旦数据库、PHP 连接、模板输出均为 utf8mb4，则可以完美支持 Emoji 和特殊符号显示。