在PHP开发中，当应用需要服务不同国家地区的用户时，数字的显示规则往往存在差异，比如中文环境常用逗号作为千位分隔符、点作为小数点，而部分欧洲语言会用点作为千位分隔符、逗号作为小数点，手动处理这些规则不仅繁琐还容易出错，使用PHP内置的intl扩展可以高效解决这个问题。
环境准备
首先需要确认PHP环境已经安装并启用了intl扩展，可以通过phpinfo()函数查看扩展状态，如果没有启用，需要在php.ini中添加extension=intl然后重启服务。intl扩展基于ICU库实现，内置了全球各地的区域设置规则，不需要开发者手动维护不同地区的数字格式配置。
NumberFormatter基本用法
NumberFormatter是intl扩展中专门用于处理数字格式化的类，核心使用步骤如下：
- 根据目标区域创建NumberFormatter实例
- 调用对应的格式化方法处理数字
- 输出格式化后的结果
下面是一个最基础的示例，实现中文环境和英文环境下普通数字的格式化：
<?php
// 中文简体区域，对应中国地区数字规则
$formatterZh = new NumberFormatter('zh_CN', NumberFormatter::DECIMAL);
// 英文美国区域，对应美国地区数字规则
$formatterEn = new NumberFormatter('en_US', NumberFormatter::DECIMAL);
$num = 1234567.89;
echo "中文环境显示：" . $formatterZh->format($num) . PHP_EOL;
echo "英文环境显示：" . $formatterEn->format($num) . PHP_EOL;
?>上述代码执行后，中文环境会输出1,234,567.89，英文环境同样输出1,234,567.89，因为这两个区域的普通数字格式规则一致。如果换成法语区域，结果会有明显差异：
<?php
// 法语法国区域
$formatterFr = new NumberFormatter('fr_FR', NumberFormatter::DECIMAL);
$num = 1234567.89;
echo "法语环境显示：" . $formatterFr->format($num) . PHP_EOL;
?>执行后会输出1 234 567,89，千位分隔符变成了空格，小数点变成了逗号，符合法国地区的数字显示习惯。
不同数字类型的格式化
百分比格式化
如果需要显示百分比，只需要修改NumberFormatter的样式为NumberFormatter::PERCENT：
<?php
$formatter = new NumberFormatter('zh_CN', NumberFormatter::PERCENT);
$rate = 0.156; // 表示15.6%
echo "百分比显示：" . $formatter->format($rate) . PHP_EOL;
?>中文环境下会输出16%，因为默认会进行四舍五入，如果需要保留更多小数，可以通过setAttribute方法设置小数位数：
<?php
$formatter = new NumberFormatter('zh_CN', NumberFormatter::PERCENT);
// 设置百分比保留2位小数
$formatter->setAttribute(NumberFormatter::FRACTION_DIGITS, 2);
$rate = 0.156;
echo "保留2位小数的百分比：" . $formatter->format($rate) . PHP_EOL;
?>此时会输出15.60%，符合需求。
货币格式化
货币显示需要同时适配数字格式和货币符号，使用NumberFormatter::CURRENCY样式，并且需要指定货币类型：
<?php
// 人民币，中国区域
$formatterCny = new NumberFormatter('zh_CN', NumberFormatter::CURRENCY);
// 美元，美国区域
$formatterUsd = new NumberFormatter('en_US', NumberFormatter::CURRENCY);
$amount = 1999.99;
echo "人民币显示：" . $formatterCny->formatCurrency($amount, 'CNY') . PHP_EOL;
echo "美元显示：" . $formatterUsd->formatCurrency($amount, 'USD') . PHP_EOL;
?>中文环境会输出¥1,999.99，英文环境会输出$1,999.99，自动适配了对应区域的货币符号和格式。
科学计数法格式化
对于极大或极小的数字，可以使用科学计数法格式：
<?php
$formatter = new NumberFormatter('zh_CN', NumberFormatter::SCIENTIFIC);
$bigNum = 123456789;
echo "科学计数法显示：" . $formatter->format($bigNum) . PHP_EOL;
?>中文环境下会输出1.23456789E8，符合科学计数法的显示规范。
自定义格式化规则
如果内置的区域规则不能完全满足需求，还可以通过NumberFormatter的属性设置方法自定义规则，比如强制设置千位分隔符和小数点符号：
<?php
$formatter = new NumberFormatter('zh_CN', NumberFormatter::DECIMAL);
// 自定义千位分隔符为空格
$formatter->setSymbol(NumberFormatter::GROUPING_SEPARATOR_SYMBOL, ' ');
// 自定义小数点符号为逗号
$formatter->setSymbol(NumberFormatter::DECIMAL_SEPARATOR_SYMBOL, ',');
$num = 1234567.89;
echo "自定义格式显示：" . $formatter->format($num) . PHP_EOL;
?>此时会输出1 234 567,89，和法语区域的默认规则一致，方便开发者灵活调整显示效果。
常见问题说明
如果创建NumberFormatter时传入了不存在的区域代码，会返回null，需要先判断实例是否创建成功再调用格式化方法，避免报错。另外intl扩展的格式化结果是字符串类型，如果需要后续进行数值计算，不要直接使用格式化后的结果，应该保留原始数值进行处理。
通过NumberFormatter类，开发者可以快速实现多语言场景下的各类数字格式化需求，不需要手动维护不同地区的规则，大幅降低了国际化适配的工作量，是PHP处理多语言数字显示的最优方案。
PHP数字格式化多语言NumberFormatterintl扩展修改时间：2026-06-04 06:41:23