PHP数字格式化本地化

本文目录导读：

1. 使用 number_format()（基础格式化，非自动本地化）
2. 使用 NumberFormatter 类（推荐，真正的本地化）
3. 获取当前用户的 Locale（自动检测语言环境）
4. 使用 setlocale() 和 money_format()（旧方法，已废弃/不推荐）
5. 手动处理（不使用扩展，适合简单场景）
6. 总结建议

在PHP中,数字格式化的本地化主要涉及千位分隔符、小数点符号、货币符号以及语言环境（Locale）的处理。

以下是几种常用的本地化数字格式化方案：

使用 number_format()（基础格式化，非自动本地化）

number_format() 是 PHP 内置的函数，但它不会自动根据用户的语言环境切换符号，你需要手动指定小数点符号和千位分隔符。

<?php
// 默认格式（美式英语）：1,234.56
echo number_format(1234.56);
// 指定小数位、小数点、千位分隔符（德式格式）：1.234,56
echo number_format(1234.56, 2, ',', '.');
// 法式/西班牙式：1 234,56（空格作为分隔符）
echo number_format(1234.56, 2, ',', ' ');
?>

缺点：number_format 本身不感知区域设置，你需要自己根据用户地区传参，或者使用扩展。

使用 NumberFormatter 类（推荐，真正的本地化）

NumberFormatter 是 Intl 扩展 的核心类，它功能强大，能直接根据 Locale 代码（如 en_US，de_DE，zh_CN）自动输出符合当地习惯的数字。

前提：需要 PHP 启用 intl 扩展。

1 格式化普通数字

<?php
// 创建格式化器（英文美国）
$fmt_us = new NumberFormatter('en_US', NumberFormatter::DECIMAL);
echo $fmt_us->format(1234567.891); // 输出: 1,234,567.891
// 创建格式化器（德文德国，小数用逗号）
$fmt_de = new NumberFormatter('de_DE', NumberFormatter::DECIMAL);
echo $fmt_de->format(1234567.891); // 输出: 1.234.567,891
// 创建格式化器（中文中国）
$fmt_zh = new NumberFormatter('zh_CN', NumberFormatter::DECIMAL);
echo $fmt_zh->format(1234567.891); // 输出: 1,234,567.891
?>

2 设置小数位数

<?php
$fmt = new NumberFormatter('en_US', NumberFormatter::DECIMAL);
// 设置最多2位小数（不足补零使用 setAttribute）
$fmt->setAttribute(NumberFormatter::FRACTION_DIGITS, 2);
$fmt->setAttribute(NumberFormatter::MIN_FRACTION_DIGITS, 2);
echo $fmt->format(1234.5); // 输出: 1,234.50
?>

3 格式化货币（强烈推荐）

<?php
// 货币格式化会自动带上货币符号和正确的位数
$fmt_us = new NumberFormatter('en_US', NumberFormatter::CURRENCY);
echo $fmt_us->formatCurrency(1234.56, 'USD'); // 输出: $1,234.56
$fmt_de = new NumberFormatter('de_DE', NumberFormatter::CURRENCY);
echo $fmt_de->formatCurrency(1234.56, 'EUR'); // 输出: 1.234,56 €
$fmt_zh = new NumberFormatter('zh_CN', NumberFormatter::CURRENCY);
echo $fmt_zh->formatCurrency(1234.56, 'CNY'); // 输出: ¥1,234.56
?>

获取当前用户的 Locale（自动检测语言环境）

如果你需要根据用户浏览器的语言来动态决定格式化方式,可以结合 Locale::acceptFromHttp 使用：

<?php
// 模拟用户的 HTTP Accept-Language 头
$lang = $_SERVER['HTTP_ACCEPT_LANGUAGE'] ?? 'en-US';
// 提取最匹配的 Locale
$locale = Locale::acceptFromHttp($lang); //  en_US, de_DE, zh_CN
// 创建格式化器
$fmt = new NumberFormatter($locale, NumberFormatter::DECIMAL);
echo $fmt->format(1234567.891);
?>

使用 setlocale() 和 money_format()（旧方法，已废弃/不推荐）

PHP 8.0 起 money_format() 已被移除，因此不推荐在新项目中使用，如果你只需要根据 setlocale 改变小数点和分隔符，没有原生函数能做到，必须依赖 NumberFormatter 或手动 number_format。

手动处理（不使用扩展，适合简单场景）

如果你无法启用 intl 扩展，可以自己写一个本地化函数：

<?php
function format_number_locale($number, $locale = 'en_US') {
    $locales = [
        'en_US' => [',', '.', 2],
        'de_DE' => ['.', ',', 2],
        'fr_FR' => [' ', ',', 2],
        'zh_CN' => [',', '.', 2],
    ];
    $config = $locales[$locale] ?? $locales['en_US'];
    list($thousands_sep, $decimal_point, $decimals) = $config;
    return number_format($number, $decimals, $decimal_point, $thousands_sep);
}
echo format_number_locale(1234567.891, 'de_DE'); // 1.234.567,89
?>

总结建议

最佳实践：如果你的项目是多语言或多地区的，强烈建议安装并在代码中使用 intl 扩展，它提供了最标准、最全面的本地化支持，且性能优于纯 PHP 实现。