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

Laravel utf8mb4字符集与MySQL服务端配置【服务端】

星明吖_9662

星明吖_9662

发布时间:2026-08-06 21:01:52

|

673人浏览过

|

来源于php中文网

原创

必须确保MySQL服务端启用utf8mb4支持,否则Laravel存取emoji和生僻汉字会报错或显示问号;需确认MySQL版本≥5.5.3,修改my.cnf/my.ini三段配置并重启服务,建库时显式指定字符集,旧库旧表须手动转换且注意索引长度限制。

laravel utf8mb4字符集与mysql服务端配置【服务端】

要让Laravel应用正确存取emoji和生僻汉字,必须先确保MySQL服务端已启用utf8mb4支持——只改Laravel配置而忽略服务端,插入时会直接报错Incorrect string value或显示问号。

确认MySQL版本是否支持utf8mb4

执行SELECT VERSION();,结果必须是5.5.3及以上;若低于此版本,升级MySQL是唯一可行路径。

MySQL 8.0默认字符集已是utf8mb4,但旧版(如5.6、5.7)仍需手动配置,且不配就无法支撑Laravel的完整Unicode需求。

修改my.cnf或my.ini配置文件

找到真实生效的配置文件路径:运行mysqld --verbose --help | grep "Default options",输出的第一行即为实际加载路径。

在该文件中,严格按以下三段写入,缺一不可:

方法一:[client]段添加默认连接字符集
default-character-set = utf8mb4

方法二:[mysql]段专用于命令行客户端自身
default-character-set = utf8mb4

方法三:[mysqld]段设服务端核心参数
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
init_connect = 'SET NAMES utf8mb4'
【skip-character-set-client-handshake = FALSE】(必须显式设为FALSE,否则客户端声明的charset会被忽略)

注意:Windows下找my.ini,Linux/macOS下优先检查/etc/my.cnf或/etc/mysql/my.cnf;若用Docker,挂载的配置文件权限必须是644,否则mysqld静默跳过。

Laravel Creem Agent
Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品,执行心跳检查,管理本地 Laravel支付商店。

下载

重启MySQL服务并验证

第一步:执行sudo systemctl restart mysqld(Linux)或net stop mysql && net start mysql(Windows);【仅SET GLOBAL无效,必须重启】。

第二步:登录MySQL,运行SHOW VARIABLES LIKE 'character_set%';;确认character_set_server、character_set_database、character_set_client三项均为utf8mb4。

第三步:再执行STATUS;,看“Current client”是否显示via TCP/IP;若显示via socket,说明[client]段可能未生效,此时用mysql -h 127.0.0.1 -u root -p强制走TCP连接重测。

创建新数据库时显式指定utf8mb4

即使服务端已配好,仍建议建库时明确声明,避免依赖默认值出偏差:
CREATE DATABASE myapp CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

这条语句比单纯靠character-set-server更可靠——它绕过了init_connect对SUPER用户的失效问题,也规避了某些MySQL发行版对默认值的覆盖行为。

已有数据库必须手动转换

第一步:执行ALTER DATABASE your_db_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;

第二步:逐个转换表,例如:
ALTER TABLE users CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

第三步:对含TEXT/BLOB字段的表,先收缩索引长度(如VARCHAR(255) → VARCHAR(191)),否则可能因max key length is 767 bytes报错。

这一步不可跳过。character-set-server只影响新库新表,老库老表的字符集完全不变,哪怕SHOW CREATE TABLE看着像utf8mb4,字段内部实际编码仍是旧的。

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

WorkBuddy

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

豆包大模型

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

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

DeepSeek

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

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

857

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

835

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2468

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3881

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

5510

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

3676

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

6909

2025.08.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

1416

2026.03.04

Kratos框架HTTP与gRPC服务开发教程
Kratos框架HTTP与gRPC服务开发教程

本专题围绕Kratos框架双协议服务开发,涵盖HTTP路由与处理器编写、参数获取、gRPC服务实现与客户端调用、metadata上下文传递、encoding编解码注册、统一响应封装、超时控制与流式响应实现方法。

0

2026.10.10

热门下载

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

精品课程

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

共1课时 | 183人学习

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

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