PHP多币种存整数分单位技巧

必须存整数单位（如分、厘），因浮点精度丢失、四舍五入不一致、数据库截断及多币种精度差异（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），由前端按币种规则格式化显示——这样连时区、语言环境导致的千分位/小数点符号问题都绕开了。

真正麻烦的不是转换逻辑，而是所有环节（表单提交、中间件、缓存、日志、对账脚本）都得对齐同一套整数单位约定；漏掉一个地方，就可能在凌晨三点收到支付不平的告警。