PHPJSON如何保留精度_php防止json丢失小数位的方法【技巧】

1次阅读

php json_encode默认丢小数位是因为浮点数在json中不保留格式,且受precision配置影响;需用sprintf等格式化为字符串才能精确控制小数位数。

PHPJSON如何保留精度_php防止json丢失小数位的方法【技巧】

PHP json_encode 为什么默认会丢小数位

PHP 的 json_encode 在处理浮点数时,会受 serialize_precisionprecision 这两个 ini 配置影响。默认情况下(PHP 7.1+),serialize_precision 是 -1,看起来“自动”,但实际底层仍按 precision(默认 14)截断有效数字,不是保留小数位数——比如 0.000000000000123456789 可能被转成 1.23456789e-13,再解析回来就失真。

更常见的是:你传入 12.3400,输出变成 12.34,看似“丢了零”,其实是 JSON 规范不区分 12.3412.3400,而 PHP 序列化时做了最简表示。

JSON_PRESERVE_ZERO_FRACTION 强制保留小数点后零

这个 flag 只对整数无效,对浮点数生效,但它真正作用是:Float 类型即使值为整数(如 12.0),也强制输出带 .0;它 控制小数位数精度,也不防止科学计数法。

  • 仅适用于 PHP ≥ 7.1
  • 必须配合 float 类型变量,不能靠字符串伪装
  • 12.3400 这种输入,PHP 已在解析阶段丢掉末尾零(因为 float 本身不存“格式”)
json_encode(['price' => 12.3400], JSON_PRESERVE_ZERO_FRACTION); // 输出:{"price":12.34} —— 没用,还是被简化了 json_encode(['price' => 12.0], JSON_PRESERVE_ZERO_FRACTION); // 输出:{"price":12.0} —— 这个才生效

真正保留小数位数:必须用字符串 + 显式格式化

JSON 本身不支持“精度元信息”,要确保下游(JS、数据库、其他服务)拿到固定小数位,唯一可靠方式是:在 PHP 层把数字格式化为字符串,并确保它确实是你要的字符形式

立即学习PHP免费学习笔记(深入)”;

  • 使用 sprintfnumber_format,注意千位分隔符问题
  • 不要用 (String)$float,它走默认精度,不可控
  • 如果字段语义明确(如金额),建议统一用“分”存整型,彻底避开浮点
$price = 12.3400; json_encode(['price' => sprintf('%.4f', $price)]); // 输出:{"price":"12.3400"}
  • sprintf('%.4f', 12.3)"12.3000"(补零)
  • sprintf('%.4f', 12.3456789)"12.3457"(四舍五入)
  • 若需截断而非四舍五入,得先 floor($x * 10000) / 10000 再格式化

注意 json_decode 的反向陷阱

前端或第三方返回的 JSON 字符串,如果含高精度数字(如 "12.345678901234567"),PHP 默认用 json_decode($json, true) 会转成 float,立刻丢失精度(尤其 > 2^53 的整数或超长小数)。

  • 必须加 JSON_BIGINT_AS_STRING 处理大整数,但对小数无效
  • 小数精度保全唯一办法:用 json_decode($json, true, 512, JSON_OBJECT_AS_ARRAY) + 手动遍历,把数字字段识别为字符串再转——不现实
  • 更可行的是:约定上游传字符串,或自己用正则/AST 解析原始 JSON 字符串提取关键字段

真正的难点不在怎么 encode,而在整个链路是否一致把“精度”当作业务契约来维护——从数据库字段类型(DECIMAL(10,4))、API 输入校验、到 JSON 输出格式,缺一不可。

text=ZqhQzanResources