PHP7.4json_encode转义规则,PHP7.3中文输出差异

秋浩君_2535

秋浩君_2535

2026-10-02

646人浏览

原创

应启用json_unescaped_unicode选项并确保输入为utf-8编码,统一源数据、脚本文件及http响应头的utf-8设置,配合mb_convert_encoding强制归一化和json_last_error精准排错。

php7.4json_encode转义规则,php7.3中文输出差异

PHP 7.4 和 7.3 的 json_encode 中文输出行为一致

只要 PHP 版本 ≥ 5.4,JSON_UNESCAPED_UNICODE 的行为就没有变化。7.3 和 7.4 在这个 flag 上完全兼容——加了就输出原样中文,不加就转成 \u4f60\u597d 这类 Unicode 序列。所谓“差异”通常来自误判:比如开发环境用的是 7.4,测试环境却是 7.2(没开 flag 就返回 null),或前端没设 Content-Type: application/json; charset=utf-8 导致浏览器乱解码。

json_encode 返回 null 的真实原因(不是版本问题)

遇到中文导致 json_encode 返回 null,几乎全是编码污染,和 PHP 小版本无关:

  • 数据库连接未设 utf8mb4,查出的字段含 GBK 字节
  • 从文件读取时没指定编码,fgets() 读入了 BOM 或混合编码字符串
  • 表单 POST 数据未经 mb_convert_encoding($str, 'UTF-8', 'auto') 清洗
  • 数组里混入了 resource(如未关闭的 mysqli 句柄)或递归引用对象

验证方式很简单:var_dump(json_last_error_msg()) —— 出现 "Malformed UTF-8 characters, possibly incorrectly encoded" 就是编码问题;出现 "Type is not supported" 就是数据类型非法。

推荐的生产级 json_encode 调用写法

不要只依赖 JSON_UNESCAPED_UNICODE,组合使用几个关键 flag 才算稳妥:

Json Schema Toolkit
Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据,从示例 JSON 生成 schema,并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载
  • JSON_UNESCAPED_UNICODE:保留中文可读性
  • JSON_UNESCAPED_SLASHES:避免 \/ 转义,防止 被 HTML 解析器截断
  • JSON_INVALID_UTF8_SUBSTITUTE(PHP 7.2+):把非法 UTF-8 字节替换成 ,而不是让整个编码失败返回 null
  • 线上环境**禁用** JSON_PRETTY_PRINT:它只增加空格换行,无业务价值,还增大传输体积

示例:

$json = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_INVALID_UTF8_SUBSTITUTE);
若仍返回 false,说明数据本身有硬伤,得回溯清洗源头,而不是调参。

最容易被忽略的隐性坑:字符串里的不可见控制字符

你看到 JSON 输出里某条标题是 "PHP\nTutorial",不是 json_encode 加的换行,而是原始字符串里真有 \n 或 \r。这类字符在 var_dump 里不显眼,但会破坏 JSON 结构有效性(尤其当值嵌在 HTML 属性中时)。解决方法不是改 flag,而是预处理:

  • 用 str_replace(["\r", "\n", "\t"], ' ', $str) 简单替换
  • 对用户输入字段用 trim(preg_replace('/\s+/', ' ', $str)) 压缩空白
  • 富文本内容必须走 htmlspecialchars($str, ENT_QUOTES, 'UTF-8') 再进 JSON(如果最终要插进 HTML)

flag 再全也救不了带脏数据的数组——json_encode 是编码器,不是清洗器。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关专题

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

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

2023.09.01

9804

6

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

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

2023.10.11

5861

5

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

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

2023.10.11

2075

5

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

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

2023.10.23

3648

4

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

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

2023.10.23

4354

6

html怎么上传
html怎么上传

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

2023.11.03

3411

9

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

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

2023.11.09

4857

8

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

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

2023.11.13

3802

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11782

4

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习