PHPのmb_encode_mimeheader()関数でMIMEヘッダー用文字列をエンコードする方法

PHPでは、mb_encode_mimeheader()関数を使用することで、MIME（Multipurpose Internet Mail Extensions）ヘッダー用に文字列をエンコードできます。この関数は、指定された文字列をMIMEヘッダーエンコード方式に従って変換し、メールヘッダー内で安全に扱えるASCII形式の文字列を生成します。

構文

string mb_encode_mimeheader(str $string, str $charset, str $transfer_encoding, str $newLine, int $indent)

パラメータ

mb_encode_mimeheader()関数は、以下の5つのパラメータを受け取ります。

• $string − エンコード対象の文字列を指定します。この文字列のエンコーディングは、mb_internal_encoding()で設定された内部エンコーディングと一致している必要があります。

• $charset − 文字列が表現される文字セット名を指定します。

• $transfer_encoding − MIMEエンコードの方式を指定します。base64（B）またはQuoted-Printable（Q）のいずれかを選択できます。省略した場合は、デフォルトでbase64（B）が適用されます。

• $newLine − mb_encode_mimeheader()が行折り返し（line-folding）を行う際に使用する行末（EOL）マーカーを指定します。

• $indent − 先頭行のインデント幅を指定します。

戻り値

この関数は、ASCII表現に変換された文字列を返します。

例1

<?php
   $name = "Online tutorials";
   $mbox = "nru";
   $doma = "gtin.thu";
   $addr = mb_encode_mimeheader($name,"UTF-7","Q")." <".$mbox."@".$doma.">";
   echo $addr;
?>

出力結果

Online tutorials

この例では、mb_encode_mimeheader()を使って送信者名をエンコードし、メールアドレス形式の文字列を組み立てています。

例2

<?php
   $string = "\xe2\x86\x92";
   mb_internal_encoding( "UTF-8");
   echo mb_encode_mimeheader($string, 'UTF-8');
?>

出力結果

=?UTF-8?B?4oaS?=

この例では、内部エンコーディングをUTF-8に設定した上で、特殊文字を含む文字列をエンコードしています。結果として、「=?UTF-8?B?4oaS?=」のようなMIMEエンコードワード形式の文字列が出力されます。これは、マルチバイト文字をメールヘッダーに安全に埋め込むための標準的な形式です。