PHP中JSON浮点精度的解决方法
在PHP开发中，将数组或对象转换为JSON字符串是非常常见的操作，我们通常会使用 json_encode() 函数。然而，当处理浮点数时，开发者经常会遇到一个令人头疼的问题：原本简短的浮点数，在经过JSON编码后，变成了带有长串尾数的数值。本文将深入探讨这一问题的原因，并提供几种切实可行的解决方法。
问题背景：浮点数精度丢失的现象
假设我们有一个包含浮点数的数组，当我们尝试将其转换为JSON时，可能会遇到以下情况：
$data = ['price' => 10.5];
echo json_encode($data);
// 期望输出: {"price":10.5}
// 实际可能输出: {"price":10.499999999999998}这种并非我们期望的输出，在前端通过 <script> 标签解析或与其他系统交互时，极易引发计算错误或逻辑异常。特别是当请求诸如 https://www.ipipp.com/api/submit 这类对数值精度要求极高的财务接口时，这种微小的偏差是绝对不可接受的。
原因分析：为什么会出现精度问题
浮点数精度问题的根源在于计算机底层对浮点数的存储机制。十进制的浮点数在转换为二进制时，往往是无限循环的，因此无法被精确表示。
在PHP中，json_encode() 函数在处理浮点数时，受制于 php.ini 中的两个关键配置项：
precision：控制普通浮点数显示的精度，默认值通常为14。serialize_precision：控制序列化（包括json_encode()）时浮点数的精度，默认值通常为-1（较新版本PHP）或14/17（较老版本）。
当 serialize_precision 的值设置得较大（如17）时，PHP会尽可能多地存储浮点数的二进制转换后的十进制表示，从而暴露了底层的精度误差。而在PHP 7.1之后，默认值改为-1，表示使用一种改进的算法来精确表示可以转换回原始二进制值的最短十进制数，这在很大程度上缓解了该问题。但在旧版本或特定配置下，问题依然存在。
解决方法
方法一：修改php.ini配置（推荐）
最彻底且最推荐的解决方法是修改 php.ini 中的配置项，将 serialize_precision 和 precision 设置为合理的值。
打开 php.ini 文件，找到并修改如下配置：
precision = 14 serialize_precision = -1
将 serialize_precision 设置为 -1 是最佳选择，这会让PHP自动选择最合适的精度进行序列化，从而避免产生长串无效数字。修改完成后，需重启PHP服务生效。
方法二：在代码中动态修改配置
如果你没有权限修改 php.ini，或者项目需要在多个不同环境中运行，可以在代码中使用 ini_set() 函数动态修改配置。
$data = ['price' => 10.5, 'discount' => 0.03];
// 动态设置精度
ini_set('precision', 14);
ini_set('serialize_precision', -1);
echo json_encode($data);
// 输出: {"price":10.5,"discount":0.03}这种方法具有灵活性，只需在执行 json_encode() 之前调用即可，不会影响其他不受控的代码段。
方法三：强制转换为字符串或使用sprintf格式化
在某些极端情况下，如果你需要绝对精确的财务数据，浮点数本身就不适合用于存储和传输。最佳实践是在JSON编码前，将浮点数格式化为指定小数位数的字符串，或者直接在业务层使用整型（如以分为单位存储金额）。
$price = 10.50000000000001;
// 方法1：使用 sprintf 格式化后再编码
$formattedPrice = sprintf('%.2f', $price);
$data1 = ['price' => $formattedPrice];
echo json_encode($data1);
// 输出: {"price":"10.50"}
// 方法2：使用 JSON_PRESERVE_ZERO_FRACTION 选项（确保整数浮点数依然带小数点）
$data2 = ['price' => 10.0];
echo json_encode($data2, JSON_PRESERVE_ZERO_FRACTION);
// 输出: {"price":10.0} 而不是 {"price":10}将金额处理为字符串传给前端或外部接口（如 https://www.ipipp.com/api/checkout ），由接收方自行转换计算，是避免精度丢失的终极防线。
总结与最佳实践
PHP中JSON浮点数精度问题本质上是底层二进制存储与十进制转换之间的矛盾。针对不同场景，建议采取以下策略：
对于PHP 7.1+的环境，确保
serialize_precision = -1。对于旧版PHP或无法修改全局配置的情况，使用
ini_set()动态设置。对于财务等对精度要求极高的业务，避免使用浮点数，改用整型运算或字符串格式化。
掌握上述方法，即可彻底告别PHP中JSON浮点精度丢失的困扰，编写出更加健壮的代码。