［PHP］money_format関数の使い方完全ガイド – 通貨フォーマット処理を詳細解説

はじめに

PHPで金額や通貨を扱うWebアプリケーションを開発していると、「¥1,000」や「$1,234.56」のような通貨フォーマットで数値を表示したい場面が頻繁に出てきます。そんなときに便利なのがmoney_format関数です。

しかし、この関数には重要な注意点があります。PHP 7.4.0で非推奨となり、PHP 8.0.0で完全に削除されました。現在の開発では代替手段を使用する必要がありますが、レガシーコードの保守や移行のために、この関数の理解は今でも重要です。

money_format関数とは？

money_format関数は、数値を指定した通貨フォーマットで文字列として返すPHPの組み込み関数でした。内部的にはC言語のstrfmon関数を使用していたため、システムのロケール設定に依存した動作をします。

基本的な構文

string money_format(string $format, float $number)

$format: フォーマット文字列
$number: フォーマットする数値
戻り値: フォーマットされた文字列

フォーマット文字列の指定方法

money_format関数の核心は、フォーマット文字列の理解にあります。基本的な構造は以下のとおりです：

%[フラグ][幅][.精度]変換文字

主な変換文字

%i: 国際通貨フォーマット（例：USD 1,234.56）
%n: 国内通貨フォーマット（例：$1,234.56）
%%: パーセント文字そのもの

フラグの種類

=文字: パディング文字を指定
^: グループ化を無効にする
+: 正の値に+記号を付ける
(: 負の値を括弧で囲む
!: 通貨記号を除外する
-: 左詰めにする

実際の使用例

基本的な使用例

// ロケールを設定
setlocale(LC_MONETARY, 'ja_JP.UTF-8');

$amount = 1234.56;

// 基本的なフォーマット
echo money_format('%n', $amount);  // 出力例：¥1,235
echo money_format('%i', $amount);  // 出力例：JPY 1,235

より詳細なフォーマット指定

setlocale(LC_MONETARY, 'en_US.UTF-8');

$amount = 1234.56;

// 小数点以下2桁まで表示
echo money_format('%.2n', $amount);     // $1,234.56

// 幅を指定してパディング
echo money_format('%12.2n', $amount);   // "   $1,234.56"

// 0でパディング
echo money_format('%=012.2n', $amount); // "$0001,234.56"

// 負の値を括弧で表示
echo money_format('%(#8.2n', -$amount); // "($1,234.56)"

複数のロケールでの表示

$amount = 1234.56;

// 日本円
setlocale(LC_MONETARY, 'ja_JP.UTF-8');
echo money_format('%n', $amount) . "\n";  // ¥1,235

// 米ドル
setlocale(LC_MONETARY, 'en_US.UTF-8');
echo money_format('%n', $amount) . "\n";  // $1,234.56

// ユーロ
setlocale(LC_MONETARY, 'de_DE.UTF-8');
echo money_format('%n', $amount) . "\n";  // 1.234,56 €

注意すべきポイント

1. システム依存性

money_format関数は、システムのロケール設定に大きく依存します。Windowsでは利用できない場合があり、Linuxでも必要なロケールがインストールされていない場合は期待した結果が得られません。

2. ロケール設定の重要性

// ロケール設定が不適切な場合
setlocale(LC_MONETARY, 'invalid_locale');
echo money_format('%n', 1234.56); // 期待した結果が得られない

3. 精度の問題

浮動小数点数を扱うため、計算結果を直接渡すと精度の問題が発生する可能性があります：

$result = 10.1 + 10.2; // 20.299999999999997
echo money_format('%.2n', $result); // 予期しない結果の可能性

現代的な代替手段

PHP 8.0以降では、money_format関数が削除されているため、以下の代替手段を使用します。

1. NumberFormatter クラス（推奨）

$formatter = new NumberFormatter('ja_JP', NumberFormatter::CURRENCY);
echo $formatter->formatCurrency(1234.56, 'JPY'); // ¥1,235

2. 独自の関数を作成

function formatMoney($amount, $currency = 'JPY', $locale = 'ja_JP') {
    $formatter = new NumberFormatter($locale, NumberFormatter::CURRENCY);
    return $formatter->formatCurrency($amount, $currency);
}

echo formatMoney(1234.56, 'USD', 'en_US'); // $1,234.56

3. sprintf関数を使用した簡易版

function simpleMoneyFormat($amount, $symbol = '¥') {
    return $symbol . number_format($amount, 0);
}

echo simpleMoneyFormat(1234.56); // ¥1,235

レガシーコードの移行方法

既存のプロジェクトでmoney_formatを使用している場合は、以下の手順で移行することをお勧めします：

ステップ1: 使用箇所の特定

# プロジェクト内のmoney_format使用箇所を検索
grep -r "money_format" /path/to/your/project

ステップ2: ラッパー関数の作成

if (!function_exists('money_format')) {
    function money_format($format, $number) {
        // NumberFormatterを使った代替実装
        $formatter = new NumberFormatter('ja_JP', NumberFormatter::CURRENCY);
        return $formatter->formatCurrency($number, 'JPY');
    }
}

ステップ3: 段階的な置き換え

一度にすべてを変更するのではなく、機能ごとに段階的に新しい実装に置き換えていくことが安全です。

パフォーマンスの考慮

money_format関数（および代替手段）は、大量のデータを処理する際にパフォーマンスの問題を引き起こす可能性があります：

// 非効率な例
for ($i = 0; $i < 1000; $i++) {
    $formatter = new NumberFormatter('ja_JP', NumberFormatter::CURRENCY);
    echo $formatter->formatCurrency($amounts[$i], 'JPY');
}

// 効率的な例
$formatter = new NumberFormatter('ja_JP', NumberFormatter::CURRENCY);
for ($i = 0; $i < 1000; $i++) {
    echo $formatter->formatCurrency($amounts[$i], 'JPY');
}