讲师中心 微信公众号
AI工具推荐 视频效率加速

宝塔面板下如何修改MySQL的字符集为utf8mb4支持表情?

星强酱_1506

星强酱_1506

发布时间:2026-03-15 21:55:20

|

498人浏览过

|

来源于php中文网

原创

需将MySQL字符集全面升级为utf8mb4:修改my.cnf的[mysqld]和[client]区块、批量转换库表及字段编码、更新PHP连接参数并重启服务。

宝塔面板下如何修改mysql的字符集为utf8mb4支持表情?

如果您在宝塔面板中部署的MySQL数据库无法正确存储和显示emoji等四字节UTF-8字符,则很可能是当前MySQL字符集仍为utf8(实际为utf8mb3)或相关配置未覆盖连接、服务端、表级等全部层级。以下是修改MySQL字符集为utf8mb4以完整支持表情符号的多种操作路径:

一、修改MySQL主配置文件my.cnf

该方法通过全局配置MySQL服务端默认字符集,确保启动时加载utf8mb4相关参数,影响所有新建数据库与连接的默认行为。

1、登录宝塔面板,进入【软件商店】→ 找到已安装的MySQL → 点击右侧【设置】→ 切换到【配置修改】选项卡。

2、在编辑器中定位到[mysqld]区块,在其下方新增以下配置项:

[mysqld]

character-set-server = utf8mb4

collation-server = utf8mb4_unicode_ci

skip-character-set-client-handshake = 1

3、继续向下查找是否存在init_connect语句,若存在且值非utf8mb4相关,则将其注释或替换为:init_connect='SET NAMES utf8mb4'。

4、保存配置后,点击页面右上角【重载配置】按钮,随后点击【重启】MySQL服务。

二、修改宝塔面板内建的MySQL连接层配置

宝塔面板部分版本会通过自定义脚本控制MySQL客户端连接行为,需同步调整面板层面的连接初始化指令,避免应用层仍以旧字符集建立连接。

1、在宝塔面板中进入【数据库】→ 点击对应MySQL实例右侧【管理】→ 切换至【终端】标签页。

2、执行命令查看当前全局变量:SHOW VARIABLES LIKE 'character_set%';

3、若character_set_client、character_set_connection、character_set_results仍显示为utf8,说明连接层未生效,需手动在【配置修改】中[client]区块补充:

[client]

default-character-set = utf8mb4

4、保存并重启MySQL服务,再次执行SHOW VARIABLES验证三项是否均已变为utf8mb4。

三、批量转换现有数据库与数据表字符集

仅修改服务端配置无法自动变更已有数据库及表的字符集定义,必须显式执行ALTER语句,否则历史数据仍按原编码存储,读写表情时将出现乱码或截断。

1、在【数据库】列表中,找到目标数据库,点击右侧【管理】→ 进入phpMyAdmin。

2、左侧选择该数据库,点击顶部【SQL】选项卡,粘贴并执行以下语句(将database_name替换为实际库名):

ALTER DATABASE database_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;

3、逐个选中该数据库下的每张数据表,点击【操作】→ 在【排序规则】下拉菜单中选择utf8mb4_unicode_ci→ 勾选【更改表的排序规则及所有列的字符集】→ 点击【执行】。

4、对含TEXT或VARCHAR字段的表,还需单独执行字段级转换(例如字段名为content):

ALTER TABLE table_name MODIFY COLUMN content TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

四、修改PHP应用连接参数强制指定utf8mb4

即使数据库和服务端已设为utf8mb4,若PHP代码中未显式声明连接字符集,MySQLi或PDO仍可能沿用默认utf8,导致插入表情失败。

1、检查网站根目录下数据库连接代码,如使用MySQLi,确认存在类似语句:

$mysqli->set_charset("utf8mb4");

2、如使用PDO,确认DSN中包含charset参数:

$dsn = "mysql:host=localhost;dbname=xxx;charset=utf8mb4";

3、若使用ThinkPHP、Laravel等框架,需进入对应数据库配置文件(如database.php),将charset字段明确设为'charset' => 'utf8mb4'。

4、修改后清空PHP OPcache或重启PHP服务(宝塔中进入【软件商店】→ PHP版本 → 【设置】→ 【服务】→ 【重启】)。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

20

2026.10.28

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

0

2026.10.28

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

0

2026.10.28

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

120

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

60

2026.10.22

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

60

2026.10.22

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。

40

2026.10.22

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。

60

2026.10.22

Golangci-lint配置文件与规则设置
Golangci-lint配置文件与规则设置

本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。

20

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn