当前位置:首页 > 文章列表 > 文章 > php教程 > PHP使用json_encode转换数组为JSON字符串详解

PHP使用json_encode转换数组为JSON字符串详解

2026-03-04 13:37:43 0浏览 收藏
本文深入解析了PHP中json_encode()函数将数组或对象安全、准确转换为JSON字符串的核心要点,涵盖其不可替代性、常见返回空字符串或null的根本原因(如resource类型、非UTF-8编码、大数溢出、递归引用等),并提供基于json_last_error_msg()的精准排错方法;同时详解关键参数组合(如JSON_UNESCAPED_UNICODE、JSON_THROW_ON_ERROR)的实际效果,厘清关联数组与索引数组输出差异的底层逻辑,并针对中文乱码、emoji报错、浮点数精度丢失等高频痛点给出从数据源头治理的落地解决方案,强调统一UTF-8编码、大整数字符串化、异常捕获降级等生产环境必备实践。

php json怎么生成_json_encode将数组转为JSON字符串【详解】

json_encode() 是 PHP 中将数组(或对象)转为 JSON 字符串的唯一标准方式,没有替代函数,也不需要手动拼接。

为什么 json_encode() 有时返回空字符串或 null

这不是函数失效,而是输入数据包含不支持的类型或编码问题:

  • 数组中存在 resource 类型(如数据库连接句柄、文件指针)
  • 字符串是 GBK/GB2312 编码,而 json_encode() 只接受 UTF-8
  • 数值超出 PHP 整型范围(如 64 位大整数在 32 位系统上会变成 float,再被 JSON 序列化为科学计数法或丢失精度)
  • 递归引用对象(PHP 7.4+ 会抛出 JsonException,旧版本静默失败)

排查方法:先用 var_dump(json_last_error_msg()) 查错误原因,再用 is_array($data) && array_is_list($data) || is_object($data) 确保结构合法。

json_encode() 常用参数组合与效果

默认行为只处理 ASCII 控制字符和 <>&,中文直接输出;加参数才能控制格式和兼容性:

  • JSON_UNESCAPED_UNICODE:保留中文原样(否则转成 \uXXXX)
  • JSON_UNESCAPED_SLASHES:不转义 /(避免 被误解析)
  • JSON_PRETTY_PRINT:换行缩进,仅用于调试,线上禁用(体积增大且无意义)
  • JSON_INVALID_UTF8_SUBSTITUTE:自动替换非法 UTF-8 字节为 ,避免整个编码失败
  • JSON_THROW_ON_ERROR:让失败时抛出 JsonException,而非静默返回 false
echo json_encode(['name' => '张三', 'score' => 95], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
// 输出:{"name":"张三","score":95}

关联数组 vs 索引数组:输出结果完全不同

PHP 不区分「对象」和「关联数组」,json_encode() 仅靠键名类型判断输出结构:

  • 纯数字键且连续(0,1,2…)→ 输出 JSON 数组 []
  • 含非数字键(如 'id'、'user_name')或不连续数字键 → 输出 JSON 对象 {}
  • 混合键名(如 [0 => 'a', 'b' => 'c'])→ 强制输出对象,即使看起来像列表

若需强制转为数组,先用 array_values($arr) 重置键名;若需确保是对象,可封装为 (object)$arr(但注意 public 属性限制)。

中文乱码、emoji 报错、浮点数精度丢失怎么解

这些不是 json_encode() 的 bug,而是数据源头没清理好:

  • MySQL 查询前执行 SET NAMES utf8mb4,并用 mysqli_set_charset($conn, 'utf8mb4')
  • 读取文件后用 mb_convert_encoding($str, 'UTF-8', 'auto') 统一编码
  • 处理大整数(如微信 openid、雪花 ID)时,不要用 int 接收,改用 string 类型存储和输出(加 JSON_NUMERIC_CHECK 会适得其反)
  • 浮点数如 3.141592653589793 默认保留 14 位,若需完整精度,先用 sprintf('%.17g', $float) 转字符串再 encode

最稳妥的做法:所有输入数据在进 json_encode() 前,用 json_encode($data, JSON_THROW_ON_ERROR) 包裹,并捕获异常做降级处理(如记录日志 + 返回空对象)。

到这里,我们也就讲完了《PHP使用json_encode转换数组为JSON字符串详解》的内容了。个人认为,基础知识的学习和巩固,是为了更好的将其运用到项目中,欢迎关注golang学习网公众号,带你了解更多关于的知识点!

Win10闪屏解决方法及显卡修复指南Win10闪屏解决方法及显卡修复指南
上一篇
Win10闪屏解决方法及显卡修复指南
HTML5结构标签需闭合吗?自闭合与非自闭合区别解析
下一篇
HTML5结构标签需闭合吗?自闭合与非自闭合区别解析
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1173次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1158次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1341次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1281次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1143次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码