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

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

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学习网公众号，带你了解更多关于的知识点！