PHP NumberFormatter parseCurrency 怎样读取带货币符号的输入

如果表单里收到的是 1.234.567,89 €，目标通常不是简单地删除符号，而是同时得到金额 1234567.89 和货币码 EUR。PHP 的 NumberFormatter::parseCurrency() 正适合这个场景：它按 formatter 的地区规则解析字符串，把货币码写入引用参数，并返回数值；解析失败时返回 false。

官方文档：https://www.php.net/manual/en/numberformatter.parsecurrency.php

关键是先选对 locale，再检查返回值、货币码和 offset。不要用固定的字符串替换规则代替地区感知的解析器。

先把地区写进 NumberFormatter

小数点、千位分隔符以及货币符号的位置都可能随地区变化。德国格式常见逗号小数点和点分组，美元格式则通常使用点小数点和逗号分组。因此 formatter 的 locale 必须和输入约定一致。

parseCurrency($input, $currency, $offset);
if ($amount === false) {
    // 解析失败时读取 formatter 的错误信息，便于记录原始输入问题。
    throw new RuntimeException($formatter->getErrorMessage());
}

printf("金额: %.2f，货币: %s，结束位置: %d\\n", $amount, $currency, $offset);
// 预期含义：金额约为 1234567.89，货币码为 EUR。
?>

这里的 $currency 不是要传入的筛选条件，而是输出参数；在示例中它会被写成 EUR。金额返回的是数值，货币码则是三位代码，后续入库时可以把两者分开保存。

为什么 locale 决定能否读到货币

parseCurrency() 并不会先把所有非数字字符删掉再猜格式，它会使用当前 formatter 的地区规则理解分组符、小数符、负号和货币位置。相同的数字文本换一个 locale，结果可能不同，也可能直接解析失败。

NumberFormatter 只负责按地区格式化或解析数字，不负责汇率换算。业务层仍应明确允许的货币集合、精度和入库类型；浮点值适合展示或中间处理，金额落库时要按项目的定点数方案处理。

用 offset 把半截成功拦住

解析器可能已经读出前面的金额，但输入末尾仍然有无法解释的内容。仅判断返回值不是 false 还不够，应该把 offset 当作“解析到哪里”的信号，再决定是否接受整段输入。

parseCurrency($input, $currency, $offset);
if ($amount === false) {
    // false 表示没有得到可用的货币解析结果。
    throw new InvalidArgumentException($formatter->getErrorMessage());
}

// 去掉允许的尾部空白后，再用 offset 判断是否还有未解析字符。
$normalized = rtrim($input);
if ($offset 

offset 的用途不是替代业务校验，而是告诉你解析结束的位置。项目如果允许括号负数、前后空白或特定后缀，应先把这些规则写清楚，再统一字符串长度口径；如果要求整串必须是金额，就不能默默接受半截解析结果。

parseCurrency、parse 和 formatCurrency 怎么区分

三个 API 的方向不同，最容易出现的误区是用普通数字解析去处理带货币符号的字符串，或者把浮点数格式化 API 当成输入解析 API。

因此，导入金额文本时优先走 parseCurrency()；已经拿到数值和 ISO 货币码、准备展示时才使用 formatCurrency()。不要因为输入里出现了美元符号，就把它当作唯一的货币身份。

还有哪些容易混淆的问题？

为什么同一个符号可能对应不同货币？

符号本身不是完整的货币身份。应以输入协议、locale 或明确的 ISO 代码为准，不能用 $、¥ 这类符号单独推断国家和汇率。

解析失败时应该先改字符串吗？

先检查 formatter 的 locale、输入编码、分组符和小数符，再查看 getErrorCode() 与 getErrorMessage()。不要一上来删除所有非数字字符，否则可能丢失负号、小数位或货币语义。

为什么返回金额后还要检查 offset？

因为“读到一个金额”不等于“整段输入合法”。当输入来自用户或外部文件时，offset 能帮助业务识别额外尾部，把宽松解析和严格入库分开。

总结一下：用匹配输入的 locale 创建 CURRENCY formatter，用 parseCurrency() 取得金额和货币码，失败时读取错误信息，并用 offset 决定是否完整消费了输入。这样处理，货币符号、地区格式和业务校验各自承担清晰职责。