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

在PHP的世界里，想把数组或对象转换成JSON字符串？答案其实非常明确：json_encode() 是唯一的标准方式。这意味着你既不需要寻找替代函数，更不必费心去手动拼接字符串。

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

遇到这种情况，先别急着怀疑函数本身。问题往往出在输入的数据上，它可能包含了JSON标准不支持的类型，或者存在编码上的“硬伤”：

• 数组中混入了 resource 类型，比如数据库连接句柄或文件指针。
• 字符串使用了GBK或GB2312这类非UTF-8编码，而 json_encode() 只认UTF-8。
• 数值超出了PHP整型的范围（例如，在32位系统上处理64位大整数），导致其被转为浮点数，进而在JSON序列化时变成科学计数法或精度丢失。
• 对象内部存在递归引用（PHP 7.4及以上版本会直接抛出 JsonException，而旧版本则会静默失败）。

排查起来其实有章可循：先用 var_dump(json_last_error_msg()) 揪出错误根源，再用 is_array($data) && array_is_list($data) || is_object($data) 这样的逻辑验证数据结构是否合法。

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

这个函数的默认行为相当“基础”：它只处理ASCII控制字符以及 <、>、& 这类特殊符号，对于中文字符则会直接输出。想要更精细地控制格式和兼容性？那就得借助它的参数了：

立即学习“PHP免费学习笔记（深入）”；

• JSON_UNESCAPED_UNICODE：让中文字符保持原样输出，而不是变成一长串的 \uXXXX 转义序列。
• JSON_UNESCAPED_SLASHES：不对斜杠 / 进行转义，可以有效避免某些场景下的误解析。
• JSON_PRETTY_PRINT：为生成的JSON添加换行和缩进，让结构一目了然。记住，这个参数仅限调试时使用，线上环境务必禁用，因为它会无谓地增大数据体积。
• JSON_INVALID_UTF8_SUBSTITUTE：遇到非法的UTF-8字节时，自动将其替换为Unicode替换字符（），从而避免整个编码过程失败。
• 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'）或者数字键不连续 → 输出JSON对象 {}。
• 键名混合了数字和字符串（如 [0 => 'a', 'b' => 'c']）→ 无论看起来多像列表，都会强制输出为对象。

如果需要强制输出为数组，可以先用 array_values($arr) 重置键名。反过来，如果想确保输出为对象，可以将数组封装为 (object)$arr（不过要注意公有属性的限制）。

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

这些问题常常被误认为是 json_encode() 的bug，但追根溯源，问题往往出在数据准备阶段：

• 中文乱码：确保数据源编码正确。从MySQL查询前，执行 SET NAMES utf8mb4，并使用 mysqli_set_charset($conn, 'utf8mb4') 设置连接字符集。
• 编码统一：读取外部文件后，使用 mb_convert_encoding($str, 'UTF-8', 'auto') 将字符串统一转换为UTF-8编码。
• 大整数处理：像微信openid、雪花ID这类大整数，不要用 int 类型接收，从一开始就作为 string 类型存储和传递。特别注意，使用 JSON_NUMERIC_CHECK 参数反而会弄巧成拙，将其转为数字。
• 浮点数精度：默认情况下，浮点数（如 3.141592653589793）在JSON中会保留约14位有效数字。如果需要完整精度，可以先用 sprintf('%.17g', $float) 将其格式化为字符串，再进行编码。

最稳妥的实践方案是：在所有数据进入 json_encode() 之前，就用 json_encode($data, JSON_THROW_ON_ERROR) 进行包裹，并做好异常捕获和降级处理（例如记录日志并返回一个空对象）。

上面是php json怎么生成_json_encode将数组转为JSON字符串【详解】的内容了，文章的版权归原作者所有，如有侵权，请及时联系本站删除，更多相关jsonencode的资讯，请关注收藏本站。