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

Laravel JSON返回乱码?Laragon编码设置法

大婷吖_7454

大婷吖_7454

发布时间:2026-08-20 14:53:50

|

418人浏览过

|

来源于php中文网

原创

Laravel返回JSON中文乱码主因是Windows环境下编码链路断裂,需统一PHP文件(UTF-8无BOM)、Apache响应头(AddDefaultCharset utf-8)、MySQL连接(utf8mb4+SET NAMES)、Artisan终端(chcp 65001),并用response()->json($data, 200, [], JSON_UNESCAPED_UNICODE)确保中文不转义。

laravel json返回乱码?laragon编码设置法

Laravel 返回 JSON 出现中文乱码,问题通常不在 Laravel 本身,而在于环境编码链路断裂——尤其是使用 Laragon 这类 Windows 本地开发环境时,PHP、终端、Web 服务器(nginx/Apache)和文件系统之间的 UTF-8 协调容易出错。Laragon 默认配置虽友好,但不自动解决所有编码场景,需针对性调整。

确认乱码本质是 JSON 字符串被错误解码

不是数据库或模型没读出中文,而是响应体中的中文在传输或显示环节被当成了 GBK/ANSI 解析。典型表现:
• 浏览器开发者工具 Network → Response 显示正常中文,但前端 console.log(res) 打印出 \u4f60\u597d 或方块
• Postman 显示乱码,但用 curl -H "Accept: application/json" http://... 查看原始响应却是正常 UTF-8 字节
• 记事本打开返回的 .json 文件显示“?”或空白——大概率是文件被保存为 UTF-8 with BOM(Windows 记事本老毛病)

Laragon 环境下的关键设置点

• PHP 文件本身必须存为 UTF-8 无 BOM:控制器、Resource、配置文件等所有 .php 文件,用 VS Code / Notepad++ 等编辑器另存为 “UTF-8”(明确勾选“无 BOM”),别选“UTF-8 with BOM”
• Apache/Nginx 响应头强制声明 charset:Laragon 默认 Apache 配置中,可在 laragon/etc/apache2/conf.d/charset.conf 添加一行:
AddDefaultCharset utf-8
重启 Apache 生效。这确保即使 response()->json() 没显式设 header,Content-Type 也带 ; charset=utf-8
• MySQL 连接层统一 UTF-8:在 .env 中确认:
DB_CONNECTION=mysql
DB_CHARSET=utf8mb4
DB_COLLATION=utf8mb4_unicode_ci
并在 config/database.php 的 mysql 配置里补上:
'options' => [PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4"]
• Artisan 终端编码修正(Windows 必做):Laragon 自带终端默认用 CMD,编码为 GBK。打开 Laragon 主界面 → Menu → Terminal → Edit startup script,在开头插入:
@chcp 65001 >nul
这样每次启动终端自动切到 UTF-8,避免 php artisan tinker 或日志输出乱码

Comprehensive Three.js 3D graphics reference
Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

代码层防乱码的硬性写法

• 用 response()->json(),别手动 json_encode() + header()
• 中文不转 Unicode:显式加 JSON 编码选项
return response()->json($data, 200, [], JSON_UNESCAPED_UNICODE);
• 若用 API Resource,确保 toArray() 返回的是原生中文字符串,不要提前 utf8_encode() 或其它转换
• 避免在中间件或控制器里 echo、var_dump() 后忘记 exit——一旦 HTTP 头发出,后续 JSON 就会变成纯文本拼接

快速验证是否修复成功

• 写一个测试路由:
Route::get('/test-json', function () { return response()->json(['msg' => '你好世界', 'data' => ['name' => '张三']], 200, [], JSON_UNESCAPED_UNICODE); });
• 用 curl 直接测原始响应:
curl -H "Accept: application/json" http://your-app.test/test-json | hexdump -C | head -5
看到 e4 bd a0(“你”字 UTF-8 编码)而非 ef bb bf(BOM)或 c4 e3(GBK),就说明编码链路通了

热门AI工具

更多
讯飞智作

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

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

WorkBuddy

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

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

豆包大模型

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

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

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

Lovart
Lovart Hot

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

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

9304

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

5621

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2035

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

3508

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

4174

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

3271

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4657

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

3622

2023.11.13

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

60

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 181人学习

Composer手册
Composer手册

共0课时 | 0人学习

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

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