如何在 PHP 中通过Composer引入 MoneyPHP 库解决金融计算中的精度损耗-composer-PHP中文网

Money\Money 类找不到需检查 autoload 和命名空间；必须用整数 cents 构造，禁用 float；所有运算返回新实例（不可变设计）；多币种需通过 Converter 换算，不可直接加减。

如何在 php 中通过composer引入 moneyphp 库解决金融计算中的精度损耗

MoneyPHP 安装后 `Money\Money` 类找不到？检查 autoloader 和命名空间

Composer 安装成功不代表能直接用——常见问题是类没被自动加载，或命名空间写错。执行 composer require moneyphp/money 后，必须确认 vendor/autoload.php 已在入口文件中引入（比如 require 'vendor/autoload.php';），否则所有 Money\* 类都会报 Class not found。

MoneyPHP 的核心类不是 Money，而是 Money\Money（注意大小写和反斜杠）。常见错误写法：new Money(100, 'USD')（缺命名空间）或 use Money;（错，应是 use Money\Money;）。正确引入方式：

use Money\Money;
use Money\Currency;
<p>$money = new Money(10000, new Currency('USD'));</p>

为什么不能用 float 构造 `Money`？整数 cents 是硬性要求

MoneyPHP 强制使用整数表示金额（单位为最小货币单位，如美分），根本原因就是规避 float 的二进制精度问题。传入 19.99 这样的 float 会触发异常：InvalidArgumentException: Amount must be an integer。

实际开发中容易踩的坑：

前端传来的金额字符串（如 "19.99"）需先转成整数分：用 round((float)$str * 100)，但要注意浮点中间态风险；更安全的是用 bcadd 或正则提取数字部分再乘
数据库字段类型建议用 INT 或 BIGINT 存 cents，而非 DECIMAL(10,2) 或 FLOAT
Money::fromString() 可解析字符串（如 Money::fromString('19.99', new Currency('USD'))），内部已做安全转换，推荐优先使用

`Money::add()` 和 `Money::subtract()` 为什么返回新实例而不是修改原对象？

MoneyPHP 是 immutable（不可变）设计，所有运算方法（add、subtract、multiply、divide）都返回全新 Money 实例，原对象不变。这不是 bug，是刻意为之——避免意外共享状态引发精度污染。

典型误用：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

$total = new Money(10000, $usd);
$total->add(new Money(5000, $usd)); // ❌ 无效果！返回值被丢弃
echo $total->getAmount(); // 还是 10000

正确写法：

$total = $total->add(new Money(5000, $usd)); // ✅ 赋值回变量
// 或一步到位
$total = (new Money(10000, $usd))->add(new Money(5000, $usd));

注意：multiply() 默认返回整数结果，若需小数位（如汇率换算），必须显式传入 Math\Decimal 实现，否则会截断——这点文档不明显，容易导致换算失真。

多币种计算时 `Money::convert()` 报错 “Currency mismatch” 怎么办？

Money 实例之间不能直接加减不同币种，这是设计约束，不是限制。想换算，必须用 Converter 接口配合汇率提供器（如 ExchangeRateProvider）。常见错误是试图 $eur->add($usd)，直接抛出 LogicException。

最小可用换算示例（需额外安装 moneyphp/iso-currencies 和汇率数据）：

use Money\Currencies\ISOCurrencies;
use Money\Exchange\Bank;
use Money\Exchange\Exchange;
<p>$currencies = new ISOCurrencies();
$bank = new Bank($currencies);
$bank->addRate('USD', 'EUR', 0.92); // 手动设简单汇率
$converter = new Exchange($bank);</p><p>$usd = Money::fromString('100.00', new Currency('USD'));
$eur = $converter->convert($usd, new Currency('EUR'));</p>

生产环境别硬编码汇率——应对接真实汇率 API（如 ECB、Open Exchange Rates），并缓存结果。汇率精度丢失（如只保留 2 位小数）会导致累积误差，建议存储和运算时用至少 6 位小数。

真正麻烦的从来不是“怎么装”，而是“怎么让团队所有人从第一天起就放弃 float + number_format 的直觉写法”。一旦有一个人绕过 Money 直接算，整个链路精度就垮了。