PHP处理JSON保留小数精度方法

PHP在处理JSON时默认会丢失浮点数的小数精度，根本原因在于JSON规范不保留数字格式、PHP底层浮点表示无法存储末尾零，且`json_encode`受`precision`等配置影响，导致如`12.3400`被简化为`12.34`，甚至高精度小数转为科学计数法而失真；`JSON_PRESERVE_ZERO_FRACTION`仅对整数值的浮点（如`12.0`）强制输出`.0`，无法控制小数位数；真正可靠的做法是主动将数字格式化为指定精度的字符串（如用`sprintf('%.4f', $price)`），或从业务源头规避浮点——例如金额统一以“分”为单位存整型；同时需警惕`json_decode`反向解析时的精度丢失，建议上游约定传字符串、数据库使用`DECIMAL`类型，并将精度作为贯穿存储、校验、序列化的全链路业务契约来保障。

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

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

更常见的是：你传入 12.3400，输出变成 12.34，看似“丢了零”，其实是 JSON 规范不区分 12.34 和 12.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 层把数字格式化为字符串，并确保它确实是你要的字符形式。

• 使用 sprintf 或 number_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 输出格式，缺一不可。

好了，本文到此结束，带大家了解了《PHP处理JSON保留小数精度方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！