XAMPP修改MySQL字符集为UTF8MB4 XAMPP支持表情符号

千强君_2154

千强君_2154

2026-05-03

271人浏览

原创

必须修改my.ini的[mysqld]段并重启mysql,否则emoji插入必报incorrect string value错误;需设character-set-server=utf8mb4、collation-server=utf8mb4_unicode_ci,且旧库旧表须手动转为utf8mb4,php连接还需显式声明charset=utf8mb4。

xampp修改mysql字符集为utf8mb4 xampp支持表情符号

必须改 my.ini 的 [mysqld] 段,否则 emoji 插入直接报错 Incorrect string value——光调 PHP 或客户端没用,根子在服务端默认字符集。

确认 MySQL 当前字符集是否真为 utf8mb4

别信 phpMyAdmin 界面显示或“看起来能输中文”,直接连命令行执行:

SHOW VARIABLES LIKE 'character_set_server';<br>SHOW VARIABLES LIKE 'collation_server';

两个结果必须分别是 utf8mb4 和 utf8mb4_unicode_ci(或 utf8mb4_general_ci)。如果 character_set_server 是 latin1 或 utf8(即 utf8mb3),说明配置根本没生效。

  • character_set_server = utf8mb4 必须写在 [mysqld] 段下,写在 [client] 或 [mysql] 里完全无效
  • 旧版 XAMPP 的 my.ini 里常有被注释掉的 character_set_server=utf8,直接取消注释并改成 utf8mb4 更稳妥,避免拼写错误或空格干扰
  • 改完不重启 MySQL 服务 = 白改;XAMPP 控制面板里点「Stop」再「Start」,不是刷新页面

修改 XAMPP 的 my.ini 配置文件路径和写法

XAMPP 在 Windows 下实际加载的配置文件是 C:\xampp\mysql\bin\my.ini,不是 conf\my.cnf 或其他位置。编辑时只动 [mysqld] 段:

MySQL
MySQL

编写正确的MySQL查询,避免字符集、索引和锁方面的常见陷阱。

下载
[mysqld]<br>character-set-server = utf8mb4<br>collation-server = utf8mb4_unicode_ci<br>skip-character-set-client-handshake

这几行必须独占一行、无多余空格、无中文标点。删掉所有 default-character-set(已废弃,且只对客户端生效);不要加 init_connect='SET NAMES utf8mb4'——它在 XAMPP 中容易引发连接失败,尤其搭配某些 PHP 扩展时。

  • skip-character-set-client-handshake 可选但推荐:强制忽略客户端声明的字符集,防止 Navicat、CMD 等工具带错参数覆盖服务端设置
  • 别在 [client] 段写 character-set-server,MySQL 会静默忽略,还可能报错退出
  • 改完保存,检查文件编码是 ANSI 或 UTF-8 无 BOM;带 BOM 的 UTF-8 会导致 MySQL 启动失败

已有数据库和表必须手动转 utf8mb4

服务端设成 utf8mb4 后,旧库旧表仍保持创建时的字符集(通常是 latin1 或 utf8),插入 emoji 依然报错。

  • 先转库:ALTER DATABASE `your_db_name` CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;
  • 再转表:ALTER TABLE `your_table` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  • 如果字段定义里显式写了 CHARACTER SET latin1,仅 CONVERT 不够,得用 MODIFY COLUMN 重申字符集
  • 注意索引长度限制:utf8mb4 下 VARCHAR(255) 的索引可能超限(InnoDB 单列索引最大 767 字节),必要时缩字段或开 innodb_large_prefix

PHP 连接必须显式声明 utf8mb4

即使 MySQL 服务端和表都设对了,PHP 默认仍用 utf8 连接,导致 mysqli_real_connect() 或 PDO DSN 未指定时,emoji 被截断或报错。

  • mysqli:连接后立刻执行 mysqli_set_charset($conn, 'utf8mb4');,不能只靠 SET NAMES
  • PDO:DSN 中必须含 ;charset=utf8mb4,例如 mysql:host=localhost;dbname=test;charset=utf8mb4
  • phpMyAdmin 需在 config.inc.php 加 $cfg['Servers'][$i]['charset'] = 'utf8mb4';,否则导出 SQL 仍可能乱码

最易忽略的一点:MySQL 5.5.3+ 才支持 utf8mb4,XAMPP 5.6+ 一般没问题,但若用极老版本(如 XAMPP 1.7.x),先升级再操作——否则配置全对也无效。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

xampp mysql

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

相关专题

更多
常用的mysql管理工具
常用的mysql管理工具

常用的mysql管理工具有:1、MySQL Workbench、phpMyAdmin、MySQL Shell、Navicat、DBeaver和DataGrip。更多关于mysql管理工具的问题,详情请看本专题下面的文章,php中文网欢迎大家前来学习。

2023.11.03

5570

11

phpmyadmin导入sql文件失败怎么办
phpmyadmin导入sql文件失败怎么办

在phpmyadmin导入sql文件失败时,可以尝试以下解决方案:1、检查文件权限和格式;2、确保文件字符集与数据库兼容;3、确认表结构兼容;4、检查外键约束和禁用外键检查;5、增加最大上传文件大小;6、分批导入或使用命令行导入;7、联系托管提供商寻求帮助。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.02

3344

7

phpmyadmin怎么改成中文
phpmyadmin怎么改成中文

通过安装中文语言包、将其上传到 phpmyadmin 目录、修改配置文件和重启 phpmyadmin,可以将 phpmyadmin 的界面改为中文。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.07

741

5

phpmyadmin访问不了怎么回事
phpmyadmin访问不了怎么回事

phpmyadmin 无法访问可能是以下原因造成:1、服务器问题:mysql 服务未运行或防火墙阻止访问;2、配置问题:安装/配置错误、错误的配置文件设置或缺少必要的 php 扩展;3、浏览器问题:浏览器缓存、扩展干扰或浏览器不兼容;4、其他原因:dns 问题、恶意软件或网络连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.07

859

6

phpMyAdmin安装教程大全
phpMyAdmin安装教程大全

本专题整合了phpMyAdmin程序安装相关教程,阅读专题下面的文章了解更多详细内容。

2025.10.31

865

23

PHPMyadmin配置
PHPMyadmin配置

本专题整合了phpmyadmin配置相关教程,阅读专题下面的文章了解更多详细步骤。

2025.12.04

509

19

XAMPP 与 phpMyAdmin 数据库管理实操
XAMPP 与 phpMyAdmin 数据库管理实操

专注于 XAMPP 内置的 phpMyAdmin 数据库管理工具,系统讲解数据库和数据表的创建与设计、SQL 语句执行、CSV/SQL 格式数据的导入导出、定时备份与一键还原、多数据库批量管理等日常操作,帮助开发者高效管理本地 MySQL 数据。

2026.04.08

335

26

XAMPP用法详解
XAMPP用法详解

本专题整合了XAMPP相关用法介绍,阅读专题下面的文章了解更多详细内容。

2026.04.08

253

20

XAMPP 安装与快速入门指南
XAMPP 安装与快速入门指南

面向零基础用户,详细介绍 XAMPP 在 Windows、macOS、Linux 三大平台上的下载、安装步骤、首次启动配置、控制面板使用以及 Apache/MySQL 服务的基本启停操作,帮助初学者在最短时间内搭建起可用的本地开发环境。

2026.04.08

230

23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程