PHPのmoney_format()関数とは？使い方と注意点をわかりやすく解説

PHPのmoney_format()関数は、数値を通貨表記の文字列にフォーマットするための関数です。setlocale()で設定したロケール（地域設定）に基づいて通貨記号や桁区切りを適用でき、成功時にはフォーマット済みの文字列を、失敗時にはNULLを返します。

注意：money_format()関数は非推奨・削除済み

money_format()関数はPHP 7.4.0で非推奨となり、PHP 8.0.0で削除されました。そのため、最新の環境では呼び出すことができません。新規開発では、Intl拡張モジュールのNumberFormatterクラスやnumber_format()関数を使うことが推奨されています。

構文

money_format(format, number)

パラメータ

• format − フォーマット方法を指定する文字列です。「%」記号を起点に、フラグ・フィールド幅・小数点以下の桁数などを組み合わせて指定します。

• number − フォーマット対象となる数値です。format文字列内の「%」記号の位置に挿入されます。

戻り値

フォーマットされた通貨文字列を返します。処理に失敗した場合はNULLを返します。

使用例1：ドイツ語ロケール（de_DE）でのフォーマット

まずsetlocale()でLC_MONETARYカテゴリにロケールを設定してから、money_format()を呼び出します。

<?php
   $input = 1000.56; 
   setlocale(LC_MONETARY, "de_DE"); 
   echo money_format("%.2n", $input);
?>

出力結果

1000.56

使用例2：イタリア語ロケール（it_IT）でのフォーマット

同じ書式指定子「%.2n」でも、ロケールが変われば通貨表記のルールも変わります。

<?php
   $number = 3825.91;
   setlocale(LC_MONETARY, 'it_IT');
   echo money_format('%.2n', $number) . "\n";
?>

出力結果

3825.91

まとめ

money_format()関数は、ロケール設定に応じて数値を通貨形式の文字列へ変換する関数でした。書式指定子「%n」（国際的な通貨形式）や「%i」（国内の通貨形式）などを組み合わせることで柔軟な表示が可能ですが、現在のPHPでは使用できません。代替手段としては、次のような方法があります。

• NumberFormatterクラス：Intl拡張モジュールを利用し、ロケールごとの通貨フォーマットに対応。

• number_format()関数：桁区切りや小数点以下の桁数を手動で指定するシンプルな方法。