mb_encode_mimeheader 関数のサンプルコード

PHP mb_encode_mimeheader 関数：メールヘッダーの文字コード変換

mb_encode_mimeheader の役割

メールヘッダーには、送信者、受信者、件名など、メールに関する様々な情報が含まれます。これらの情報は、ASCIIと呼ばれる7ビット文字コードでエンコードされることが一般的です。しかし、日本語などのマルチバイト文字は、ASCII では表現できないため、別のエンコード方式が必要になります。

mb_encode_mimeheader は、マルチバイト文字を含む文字列を、Base64 や Quoted-Printable などの MIME エンコード方式に変換します。これにより、異なる言語環境でも、メールヘッダー情報が正しく解釈されるようになります。

mb_encode_mimeheader 関数は、以下の形式で呼び出します。

mb_encode_mimeheader($str, $charset, $transfer_encoding);

• $str: エンコードする文字列
• $charset: 変換後の文字セット名 (例: "UTF-8", "ISO-2022-JP")
• $transfer_encoding: エンコード方式 (例: "B" (Base64), "Q" (Quoted-Printable))

例:

$subject = "=?UTF-8?B?44Gr44O844Gr44O85a6J?=";
$subject .= mb_encode_mimeheader("テストメール", "UTF-8", "B");

$headers = "From: [email protected]\r\n";
$headers .= "To: [email protected]\r\n";
$headers .= "Subject: $subject\r\n";
$headers .= "Content-Type: text/plain; charset=UTF-8\r\n";

mail("[email protected]", $subject, "本文", $headers);

mb_encode_mimeheader 使用時の注意点

• mb_internal_encoding 設定: mb_encode_mimeheader 関数は、mb_internal_encoding 設定と同じエンコーディングで動作する必要があります。事前に設定を確認しておきましょう。
• 文字列の長さ: エンコード後の文字列は、74バイトを超えないようにする必要があります。長すぎる場合は、改行コードで分割するなどの対策が必要です。
• エンコード方式: Base64 と Quoted-Printable のどちらを選択するかは、状況によって異なります。Base64 はより安全ですが、データサイズが大きくなります。 Quoted-Printable はデータサイズが小さくなりますが、一部のメールクライアントで正しく解釈されない可能性があります。

まとめ

mb_encode_mimeheader 関数は、メールヘッダーの文字コード変換に役立ちます。上記の解説を参考に、正しく使用して、マルチバイト文字を含むメールをスムーズに送信・受信しましょう。

mb_encode_mimeheader 関数のサンプルコード

$subject = "=?UTF-8?B?44Gr44O844Gr44O85a6J?=";
$subject .= mb_encode_mimeheader("テストメール", "UTF-8", "B");

echo $subject; // => =?UTF-8?B?44Gr44O844Gr44O85a6J?=?UTF-8?B?44Gr44O844Gr44O85a6J?=

送信者名エンコード

$from = "=?UTF-8?B?44Gr44O844Gr44O85a6J?=";
$from .= mb_encode_mimeheader("山田太郎", "UTF-8", "B");

$headers = "From: $from <[email protected]>\r\n";

echo $headers; // => From: =?UTF-8?B?44Gr44O844Gr44O85a6J?=?UTF-8?B?44Gr44O844Gr44O85a6J?= <[email protected]>

メール本文エンコード

$body = mb_encode_mimeheader("本文", "UTF-8", "Q");

$headers = "Content-Type: text/plain; charset=UTF-8\r\n";

echo $body; // => =?UTF-8?Q?=E6=9C=88=E7=94=BB=E3=81=A7=E3=81=8D=E3=82=81=E3=81=AA=E3=82=8B=E3=81=AB=E3=81=A1=E3=81=AF=E3=81=99=E3=82=8B?=\r\n\r\n

日本語を含むメール送信

$subject = "=?UTF-8?B?44Gr44O844Gr44O85a6J?=";
$subject .= mb_encode_mimeheader("テストメール", "UTF-8", "B");

$from = "=?UTF-8?B?44Gr44O844Gr44O85a6J?=";
$from .= mb_encode_mimeheader("山田太郎", "UTF-8", "B");

$body = mb_encode_mimeheader("本文", "UTF-8", "Q");

$headers = "From: $from <[email protected]>\r\n";
$headers .= "To: [email protected]\r\n";
$headers .= "Subject: $subject\r\n";
$headers .= "Content-Type: text/plain; charset=UTF-8\r\n";

mail("[email protected]", $subject, $body, $headers);

Quoted-Printable エンコード

$subject = mb_encode_mimeheader("テストメール", "UTF-8", "Q");

echo $subject; // => =?UTF-8?Q?テストメール?=

Base64 エンコード

$subject = mb_encode_mimeheader("テストメール", "UTF-8", "B");

echo $subject; // => =?UTF-8?B?44Gr44O844Gr44O85a6J?=

mb_internal_encoding 設定

mb_internal_encoding("UTF-8");

$subject = mb_encode_mimeheader("テストメール");

echo $subject; // => =?UTF-8?B?44Gr44O844Gr44O85a6J?=

長い文字列のエンコード

$long_string = str_repeat("テスト", 100);

$encoded_string = mb_encode_mimeheader($long_string, "UTF-8", "B");

echo strlen($encoded_string); // => 74

mb_encode_mimeheader 以外の代替方法

iconv 関数は、文字コード間の変換を行う関数です。mb_encode_mimeheader 同様に、メールヘッダーのエンコードにも使用できます。

$subject = iconv("UTF-8", "ISO-2022-JP", "テストメール");

echo $subject; // => "=?ISO-2022-JP?B?GyRCeQ=="

imap_mime_header_encode 関数は、メールヘッダーエンコード用の IMAP 関数です。mb_encode_mimeheader よりも多くのオプションを提供します。

$subject = imap_mime_header_encode("テストメール", "UTF-8", "B");

echo $subject; // => "=?UTF-8?B?44Gr44O844Gr44O85a6J?=