PHP localeconv() 函數詳解：獲取本地化數字與貨幣格式信息完整指南

PHP localeconv() 函數深度解析：本地化數字/貨幣格式信息獲取與實戰應用

localeconv() 返回當前 Locale 設置下的數字、貨幣格式化參數陣列，是構建多語言、多貨幣電商、財務系統的基礎工具。本文涵蓋返回值結構、關鍵字段含義、setlocale 聯動、跨平台差異、實戰格式化封裝。

一、 函數簽名與返回結構

localeconv(): array

返回關聯數組，包含以下核心鍵（部分平台可能缺失部分鍵）：

p_sign_posn / n_sign_posn 編碼含義：

二、 實戰：構建通用貨幣格式化器

class MoneyFormatter
{
    private array $localeInfo;

    public function __construct(string $locale = 'en_US.UTF-8')
    {
        setlocale(LC_MONETARY, $locale);
        $this->localeInfo = localeconv();
    }

    public function format(float $amount, string $currency = null): string
    {
        $info = $this->localeInfo;
        $symbol = $currency ? $currency : $info['currency_symbol'];
        $decimals = $info['frac_digits'];
        $point = $info['mon_decimal_point'];
        $sep = $info['mon_thousands_sep'];
        $grouping = $info['mon_grouping'];

        // 1. 絕對值格式化
        $abs = abs($amount);
        $formatted = number_format($abs, $decimals, $point, $sep);

        // 2. 符號位置
        $isNegative = $amount < 0;
        $precedes = $isNegative ? $info['n_cs_precedes'] : $info['p_cs_precedes'];
        $space = $isNegative ? $info['n_sep_by_space'] : $info['p_sep_by_space'];
        $signPosn = $isNegative ? $info['n_sign_posn'] : $info['p_sign_posn'];
        $sign = $isNegative ? $info['negative_sign'] : $info['positive_sign'];

        // 3. 組裝（簡化版，僅處理常見 0/1/3 模式）
        $spacer = $space ? ' ' : '';
        if ($precedes) {
            // $1.00 / $ 1.00
            $result = $symbol . $spacer . $formatted;
        } else {
            // 1.00$ / 1.00 $
            $result = $formatted . $spacer . $symbol;
        }

        // 4. 正負號（簡化：前置/後置）
        if ($signPosn === 1) { // 符號前置
            $result = $sign . $result;
        } elseif ($signPosn === 2) { // 符號後置
            $result = $result . $sign;
        } elseif ($signPosn === 0) { // 括號
            $result = '(' . $result . ')';
        }
        // 3/4 需要區分貨幣符號與數值，此處省略

        return $result;
    }
}

// 使用
$us = new MoneyFormatter('en_US.UTF-8');
echo $us->format(1234.56); // $1,234.56
echo $us->format(-99.9);   // -$99.90

$de = new MoneyFormatter('de_DE.UTF-8');
echo $de->format(1234.56); // 1.234,56 €
echo $de->format(-99.9);   // -99,90 €

三、 setlocale() 聯動與跨平台差異

最佳實踐：Docker 基礎鏡像預裝所需 Locale，代碼中使用標準 POSIX 名稱（en_US.UTF-8），避免 Windows/ Linux 不一致。

四、 避坑指南

五、 現代替代方案：NumberFormatter (intl 擴展)

$fmt = new NumberFormatter('zh_CN', NumberFormatter::CURRENCY);
echo $fmt->formatCurrency(1234.56, 'CNY'); // ￥1,234.56
echo $fmt->formatCurrency(1234.56, 'USD'); // US$1,234.56

// 獲取原始模式
echo $fmt->getPattern(); // ¤#,##0.00

• NumberFormatter 基於 ICU 庫，數據更權威、更新更及時
• 支持貨幣代碼自動解析符號、小數位、四捨五入規則
• 生產環境強烈建議遷移至 intl 擴展