【PHP8.x】iconv_mime_decode関数の使い方

作成日: 2025年09月11日更新日: 2025年09月29日

iconv_mime_decode関数は、MIMEエンコードされた文字列をデコードする関数です。この関数は、主に電子メールの件名やヘッダフィールドなど、標準的なASCII文字以外の文字（日本語、中国語など）を含むテキストを安全に伝送するために使用される、RFC 2047で定義されたMIMEエンコード形式の文字列を、人間が読みやすい形式に変換するために利用されます。異なる文字セットが混在する国際的な環境でメッセージを扱う際に非常に重要です。

例えば、「=?UTF-8?B?44K444Kq44OD44OU?=」のような形式でエンコードされた文字列は、この関数によって指定された文字セット（多くの場合UTF-8）の通常のテキスト「件名」にデコードされます。これにより、文字化けを防ぎ、正しい情報をユーザーに提示することができます。

この関数は、デコードしたい文字列の他に、デコード時の挙動を細かく制御するためのオプションの配列、そしてデコード後のテキストに適用する出力文字セットを引数として受け取ります。オプションでは、エンコードされた部分が複数ある場合にそれらを連結するか、デコードに失敗した際にどのような値を返すかといった挙動を設定できます。複数の文字セットが混在する複雑なテキストデータを正確に処理し、国際化されたアプリケーションで文字コードに関する問題を解決するための強力なツールとして機能します。

基本的な使い方

構文(syntax)

<?php
$string = '=?UTF-8?B?SGVsbG8gV29ybGQ=?=';
$decodedString = iconv_mime_decode($string);
?>

引数(parameters)

string $string, int $mode = 0, ?string $encoding = null

string $string: MIMEヘッダーエンコードされた文字列
int $mode = 0: デコードモードを指定する整数。デフォルトは0（MIMEヘッダーのエンコードを保持し、エンコーディングを特定する）。
?string $encoding = null: 文字列のエンコーディングを指定する。指定しない場合は、UTF-8とみなされる。

戻り値(return)

string|false

指定された文字列をMIMEヘッダーエンコーディングからデコードし、UTF-8文字列として返します。デコードに失敗した場合はfalseを返します。