必须存整数单位(如分、厘),因浮点精度丢失、四舍五入不一致、数据库截断及多币种精度差异(JPY=0位、CNY=2位、BHD=3位)等会导致资损;PHP应使用bcdiv/bcmul处理,数据库用BIGINT,API收发统一整数或带精度字符串。

PHP 中处理多币种金额,**必须存整数(分、厘等最小货币单位)**,而不是小数(如 19.99),否则会因浮点精度丢失、四舍五入不一致、数据库类型限制等问题引发资损——这不是“技巧”,是金融级落地的硬性要求。
为什么不能直接存 float 或 double 类型的小数?
PHP 的浮点数遵循 IEEE 754 标准,0.1 + 0.2 !== 0.3 是典型表现。实际中:
- 数据库字段若为
DECIMAL(10,2),插入19.99看似安全,但 PHP 运算后可能传入19.989999999999998,被截断为19.98 - 不同币种精度不同:JPY 无小数位,CNY 是 2 位,BHD 是 3 位,硬编码
round($x, 2)会出错 - JSON 序列化/反序列化、Redis 存取、跨服务传输时,浮点字符串解析行为不可控
怎么把金额转成整数单位并正确还原?
核心是统一用「基础单位」(如 CNY → 分,USD → 美分,JPY → 日元整数)做运算和存储。关键函数:bcdiv、bcmul、round(仅用于最终展示前):
示例:将用户输入的 "19.99"(CNY)转成分:
$amountStr = "19.99";
$scale = 2; // CNY 小数位数
$cents = (int) bcmul($amountStr, bcpow("10", $scale), 0); // 得到 1999
// 注意:不用 floatval() 或 (int)$amountStr * 100 —— 浮点污染立刻发生
还原时(仅用于展示):
$cents = 1999;
$scale = 2;
$formatted = bcdiv($cents, bcpow("10", $scale), $scale); // "19.99"
不同币种查表决定 $scale(如 ["CNY"=>2,"JPY"=>0,"BHD"=>3]),别硬编码。
数据库字段和 ORM 怎么配才不出错?
字段类型必须匹配整数单位:
- MySQL:用
BIGINT(非DECIMAL),避免隐式转换;例如存 CNY 用amount_cny_cents BIGINT NOT NULL - Laravel Eloquent:在模型中加访问器/修改器,禁止在
$casts里写"amount" => "float" - 不要依赖框架自动格式化:Laravel 的
money包或 Doctrine 的MoneyType若底层仍走 float,一样踩坑
写入前务必校验:is_numeric($input) && floor($input) == $input && $input >= 0(针对已转整数后的值)。
前端传参和 API 设计容易忽略的细节
API 输入应明确要求「整数单位」或「带精度的字符串」,而非小数:
- ✅ 接收
{"amount": "19.99", "currency": "CNY"},服务端按CNY的$scale=2转整数 - ✅ 接收
{"amount_cents": 1999, "currency": "CNY"},跳过字符串解析,更安全 - ❌ 拒绝
{"amount": 19.99}(JSON number 类型无法保证精度,PHP 解析后已是 float)
返回给前端也应保持整数单位(如 "amount_cents": 1999),由前端按币种规则格式化显示——这样连时区、语言环境导致的千分位/小数点符号问题都绕开了。
真正麻烦的不是转换逻辑,而是所有环节(表单提交、中间件、缓存、日志、对账脚本)都得对齐同一套整数单位约定;漏掉一个地方,就可能在凌晨三点收到支付不平的告警。