PHP NumberFormatter：解决货币格式化后字符串比较失败的问题

在使用 PHP 的 NumberFormatter 类进行货币格式化时，开发者可能会遇到一个看似奇怪的问题：明明两个字符串在视觉上完全一样，但使用 == 运算符进行比较时却返回 false。本文将深入探讨这个问题，并提供解决方案。

问题分析

正如摘要所提到的，问题通常出在格式化后的字符串中包含了不可见的空白字符。在使用 NumberFormatter::CURRENCY 格式化货币时，不同的 locale 设置可能会在货币符号和数值之间插入空格或其他类型的空白字符。这些空白字符在屏幕上可能不可见，但它们确实存在于字符串中，导致字符串比较失败。

示例代码

立即学习“PHP免费学习笔记（深入）”；

以下代码演示了这个问题：

<?php
$number = 1234567.89;
$expected = 'GBP 1,234,567.89'; // 注意这里 "GBP" 后面有一个空格
$fmt = new NumberFormatter('en_AU@currency=GBP', NumberFormatter::CURRENCY);
$currency = $fmt->formatCurrency($number, 'GBP');
echo "$expected = $currency ?" . PHP_EOL;
echo $expected == $currency ? 'equals' : "not equal";
?>

运行这段代码，你会发现即使 $expected 和 $currency 在输出时看起来完全相同，但比较结果却是 “not equal”。

调试技巧

要解决这个问题，首先需要确认字符串中是否存在不可见的空白字符。以下是一些常用的调试技巧：

1. var_dump() 函数： 使用 var_dump() 函数可以清晰地显示变量的类型和值，包括字符串中的空白字符。

   <?php
   $number = 1234567.89;
   $expected = 'GBP 1,234,567.89';
   $fmt = new NumberFormatter('en_AU@currency=GBP', NumberFormatter::CURRENCY);
   $currency = $fmt->formatCurrency($number, 'GBP');
   var_dump($expected);
   var_dump($currency);
   ?>

   通过观察 var_dump() 的输出，你可以清楚地看到字符串中是否存在额外的空格或其他空白字符。

2. strlen() 函数： 使用 strlen() 函数可以获取字符串的长度。如果两个字符串在视觉上相同，但长度不同，那么很可能其中一个字符串包含了不可见的空白字符。

   <?php
   $number = 1234567.89;
   $expected = 'GBP 1,234,567.89';
   $fmt = new NumberFormatter('en_AU@currency=GBP', NumberFormatter::CURRENCY);
   $currency = $fmt->formatCurrency($number, 'GBP');
   echo "Length of \$expected: " . strlen($expected) . PHP_EOL;
   echo "Length of \$currency: " . strlen($currency) . PHP_EOL;
   ?>

3. 直接输出并检查源码： 直接将字符串输出到浏览器，然后查看网页的源代码。在源代码中，空白字符通常会以空格或特殊字符的形式显示。

   <?php
   $number = 1234567.89;
   $expected = 'GBP 1,234,567.89';
   $fmt = new NumberFormatter('en_AU@currency=GBP', NumberFormatter::CURRENCY);
   $currency = $fmt->formatCurrency($number, 'GBP');
   echo $expected;
   echo "<br>";
   echo $currency;
   ?>

解决方案

一旦确认字符串中存在不可见的空白字符，可以使用以下方法解决：

1. trim() 函数： 使用 trim() 函数可以去除字符串开头和结尾的空白字符。

   <?php
   $number = 1234567.89;
   $expected = 'GBP 1,234,567.89';
   $fmt = new NumberFormatter('en_AU@currency=GBP', NumberFormatter::CURRENCY);
   $currency = $fmt->formatCurrency($number, 'GBP');
   $expected = trim($expected);
   $currency = trim($currency);
   echo "$expected = $currency ?" . PHP_EOL;
   echo $expected == $currency ? 'equals' : "not equal";
   ?>

2. str_replace() 函数： 使用 str_replace() 函数可以替换字符串中的特定字符。你可以将所有空白字符替换为空字符串。

   <?php
   $number = 1234567.89;
   $expected = 'GBP 1,234,567.89';
   $fmt = new NumberFormatter('en_AU@currency=GBP', NumberFormatter::CURRENCY);
   $currency = $fmt->formatCurrency($number, 'GBP');
   $expected = str_replace(' ', '', $expected); // 移除所有空格
   $currency = str_replace(' ', '', $currency); // 移除所有空格
   echo "$expected = $currency ?" . PHP_EOL;
   echo $expected == $currency ? 'equals' : "not equal";
   ?>

3. 正则表达式： 使用正则表达式可以更灵活地匹配和替换字符串中的空白字符。

   <?php
   $number = 1234567.89;
   $expected = 'GBP 1,234,567.89';
   $fmt = new NumberFormatter('en_AU@currency=GBP', NumberFormatter::CURRENCY);
   $currency = $fmt->formatCurrency($number, 'GBP');
   $expected = preg_replace('/\s+/', '', $expected); // 移除所有空白字符
   $currency = preg_replace('/\s+/', '', $currency); // 移除所有空白字符
   echo "$expected = $currency ?" . PHP_EOL;
   echo $expected == $currency ? 'equals' : "not equal";
   ?>

注意事项

• 在选择解决方案时，需要根据实际情况进行考虑。如果只需要去除字符串开头和结尾的空白字符，trim() 函数是最简单有效的选择。如果需要移除字符串中的所有空白字符，str_replace() 或正则表达式是更好的选择。
• 在进行字符串比较之前，务必确保两个字符串的编码方式相同。不同的编码方式可能会导致字符串比较失败。可以使用 mb_convert_encoding() 函数将字符串转换为相同的编码方式。
• 尽量避免硬编码期望的货币格式。不同的 locale 设置可能会导致货币格式发生变化。应该始终使用 NumberFormatter 类来格式化货币，并根据实际情况进行字符串比较。

总结

在使用 PHP NumberFormatter 进行货币格式化时，需要注意格式化后的字符串中可能包含不可见的空白字符。通过使用调试技巧和解决方案，可以轻松解决字符串比较失败的问题，确保货币格式化后的数据能被正确比较和使用。 理解并掌握这些技巧，能有效避免潜在的 bug，提高代码的健壮性和可靠性。