PHP API返回小数精度一致的关键是避免float参与json_encode,应存取字符串如"1.20",数据库用DECIMAL或VARCHAR,输出前用number_format等转固定位字符串,前端展示直接用字符串、计算则统一用整数或decimal.js。

PHP保存小数在API返回中保持精度一致,关键不在“存”,而在“序列化时不让它被自动转成科学计数法或丢失末尾零”——json_encode() 默认会把 float 当作数值处理,而 JSON 规范本身不区分 1.20 和 1.2,前端解析后必然丢失精度。
PHP输出前用字符串代替float类型
只要小数精度是业务要求(比如金额、测量值、ID编号等),就别让数字以 float 形式进 json_encode()。后端该存 string 或 int(单位换算后),输出时也保持为 string。
- 数据库字段用
DECIMAL(10,2)或VARCHAR存原始字符串(如"1.20"),读出后不 cast 成 float - 如果必须计算,算完立刻用
number_format($val, 2, '.', '')或sprintf('%.2f', $val)转成带固定位数的字符串 - 避免用
(string)$float—— 它可能输出1.2或1.2E-5,不可控
禁用json_encode对浮点数的默认处理
PHP 7.1+ 支持 JSON_PRESERVE_ZERO_FRACTION,但它只对整数有效(如 1.0 → 1.0),对 1.20 无效;真正起作用的是:不传 float 进去。
-
json_encode(['price' => 1.20], JSON_PRESERVE_ZERO_FRACTION)输出仍是{"price":1.2} - 正确做法:
json_encode(['price' => '1.20'])→{"price":"1.20"},前端拿到字符串可自行parseFloat或保留原样 - 若需全局控制,可用
JsonSerializable接口,在对象中重写jsonSerialize(),对特定字段强制返回字符串
前端解析时别依赖自动类型转换
即使后端返回 "1.20",前端若写 res.price + 0 或 Number(res.price),仍会丢零;必须按业务决定是展示还是计算。
立即学习“PHP免费学习笔记(深入)”;
- 展示用:直接插值
{res.price}(Vue/React)或el.textContent = res.price - 计算用:转成数字后,显示层再用
toFixed(2)格式化,但注意toFixed返回字符串,且存在浮点误差(如(0.1 + 0.2).toFixed(2) === "0.30"是错的,实际是"0.30000000000000004") - 更稳的做法:前端也统一用整数运算(如价格全转为分),或引入
big.js/decimal.js
最常被忽略的一点:MySQL 的 SELECT 直接查 DECIMAL 字段,PDO 默认可能把它当作 string 或 float 返回,取决于 PDO::ATTR_STRINGIFY_FETCHES 和驱动行为——务必检查 var_dump($row['price']) 的实际类型,而不是假设它“应该”是字符串。











