PHPのmb_detect_order()関数で文字エンコーディングの検出順序を設定・取得する方法

PHPのmb_detect_order()関数は、文字エンコーディングの検出順序を設定・取得するために使用されます。マルチバイト文字を扱う際に、どのエンコーディングから優先的に判定するかを制御できる便利な関数です。この関数はPHP 4.2.0以降のバージョンでサポートされています。

構文

array|bool mb_detect_order(str $encoding)

パラメータ

mb_detect_order()は、string型、array型、bool型の値を受け取るパラメータ$encodingを1つだけ受け入れます。

• $encoding − このパラメータには、文字エンコーディングの配列、またはカンマ区切りのリストを指定します。省略した場合、またはnullを指定した場合は、現在設定されている文字エンコーディングの検出順序を配列として返します。

戻り値

エンコーディングの検出順序を設定する場合、成功すればtrueを、失敗すればfalseを返します。パラメータを省略して呼び出した場合は、現在の検出順序を格納した配列が返されます。

使用例

<?php
   // 列挙リストで検出順序を設定する
   mb_detect_order("eucjp-win,sjis-win,UTF-8");

   // 配列で検出順序を設定する
   $array[] = "ASCII";
   $array[] = "JIS";
   $array[] = "EUC-JP";
   mb_detect_order($array);

   // 現在の検出順序を表示する
   echo implode(", ", mb_detect_order());
?>

出力結果

ASCII, JIS, EUC-JP

補足ポイント

この例では、まずカンマ区切りの文字列で検出順序を設定し、その後配列を使って順序を上書きしています。最後にimplode()関数と組み合わせてmb_detect_order()を引数なしで呼び出すことで、現在有効な検出順序「ASCII, JIS, EUC-JP」を確認できます。

なお、文字エンコーディングの自動検出は完全ではない場合があるため、可能であれば入力データのエンコーディングを明示的に指定することが推奨されます。mb_detect_order()は、どうしてもエンコーディングが不明なデータを扱う際の補助的な手段として活用するとよいでしょう。