PHPのmb_preferred_mime_name()関数とは？使い方とサンプルコードを解説

PHPのmb_preferred_mime_name()関数は、指定した文字エンコーディングに対応するMIME文字列（charset文字列）を取得するための関数です。MIME（Multipurpose Internet Mail Extensions）は、電子メールやWeb通信で広く使われているインターネット標準の規格であり、この関数を利用することで、特定のエンコーディングに対して推奨されるMIME charset名を簡単に取得できます。

構文

string mb_preferred_mime_name($string_encoding)

パラメータ

mb_preferred_mime_name()関数が受け取るパラメータは以下の1つだけです。

• $string_encoding − 調査対象となる文字エンコーディングを指定します。

戻り値

mb_preferred_mime_name()関数は、指定された文字セットエンコーディングに対応するMIME charset文字列を返します。該当するエンコーディングに対して推奨されるcharsetが存在しない場合は、falseを返します。

使用例

それでは、実際の使用例を見てみましょう。

<?php
   // エンコーディングの設定
   $string_encoding = "EUC-JP";
   mb_http_output($string_encoding);

   // 出力制御関数を使用
   ob_start("mb_output_handler");
   header(mb_preferred_mime_name($string_encoding));
   print_r($string_encoding);
?>

出力結果

上記のコードを実行すると、以下のような出力が得られます。

EUC-JP

補足：実務での活用ポイント

この関数は、HTTPレスポンスヘッダーの「Content-Type」を動的に設定したい場合などに特に便利です。mb_http_output()で出力用のエンコーディングを切り替えた際に、対応するMIME charset名を自動的に取得し、そのままヘッダーへ反映させるといった使い方が一般的です。

なお、PHP 8.0以降では、無効なエンコーディング名を引数に渡した場合にValueErrorがスローされる点に注意してください。PHP 7.x以前との互換性を考慮する場合は、事前にエンコーディング名の妥当性をチェックしておくと安全です。