首页 > 软件教程 >php json怎么生成_json_encode将数组转为JSON字符串【详解】

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

来源:互联网 2026-04-22 18:35:02

在PHP的世界里,想把数组或对象转换成JSON字符串?答案其实非常明确:json_encode() 是唯一的标准方式。这意味着你既不需要寻找替代函数,更不必费心去手动拼接字符串。 为什么 json_encode() 有时返回空字符串或 null 遇到这种情况,先别急着怀疑函数本身。问题往往出在输入的

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的资讯,请关注收藏本站。

侠游戏发布此文仅为了传递信息,不代表侠游戏网站认同其观点或证实其描述

热游推荐

更多
湘ICP备14008430号-1 湘公网安备 43070302000280号
All Rights Reserved
本站为非盈利网站,不接受任何广告。本站所有软件,都由网友
上传,如有侵犯你的版权,请发邮件给xiayx666@163.com
抵制不良色情、反动、暴力游戏。注意自我保护,谨防受骗上当。
适度游戏益脑,沉迷游戏伤身。合理安排时间,享受健康生活。