PHPのmb_http_output()関数でHTTP出力文字エンコーディングを取得・設定する方法

PHPのmb_http_output()関数は、HTTP出力の文字エンコーディングを取得または設定するために使用されるマルチバイト文字列関数です。この関数でエンコーディングを設定すると、以降の出力は内部エンコーディングから指定したエンコーディングへ自動的に変換されます。Webアプリケーションで文字化けを防ぎたい場合に非常に便利な関数です。

構文

string|bool mb_http_output(string $encoding = null)

パラメータ

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

• $encoding − HTTP出力の文字エンコーディングとして設定したいエンコーディング名（例：UTF-8、SJIS、EUC-JPなど）を指定します。この引数を省略した場合は、mb_http_output()は現在設定されているHTTP出力文字エンコーディングを返します。

戻り値

引数$encodingを省略して呼び出した場合、現在のHTTP出力文字エンコーディング（文字列）を返します。引数を指定して呼び出した場合は、設定に成功するとtrueを、失敗するとfalseを返します。

使用例1：現在のエンコーディングを取得する

<?php
   // 現在の出力文字エンコーディングを取得
   $string = mb_http_output();
   var_dump($string);
?>

出力結果

string(5) "UTF-8"

使用例2：出力エンコーディングを設定する

<?php
   // HTTP出力エンコーディングをShift_JISに設定
   var_dump(mb_http_output('SJIS'));

   // 設定後の値を確認
   echo mb_http_output();
?>

出力結果

bool(true)
SJIS

まとめ

mb_http_output()関数を使うことで、PHPスクリプトからHTTPレスポンスの出力文字エンコーディングを柔軟に制御できます。引数なしで呼び出せば現在の設定を確認でき、引数を渡せば新しいエンコーディングへ切り替えられます。マルチバイト文字を扱う日本語サイトなどでは、mb_internal_encoding()と組み合わせて使うことで、文字化けのない安定した出力を実現できます。