徹底解説！PHP iconv_mime_decode_headers 関数でメールヘッダーをエンコード：デコードの基本とサンプルコード

PHP iconv_mime_decode_headers 関数：エンコードされたメールヘッダーをデコードする

iconv_mime_decode_headers() 関数は、メールヘッダーに含まれるエンコードされた文字列をデコードするために使用されます。エンコードされた文字列は、Base64 や Quoted-Printable などのエンコーディング方式でエンコードされている場合があります。この関数は、エンコードされた文字列を元の文字列に変換し、それを配列として返します。

使用例

<?php

// メールヘッダー
$headers = [
  'Subject' => '=?UTF-8?B?Q29tcHV0ZXIgZXhhbXBsZSB0aXRsZQ==?=',
  'From' => '=?UTF-8?B?VGVzdCBTZXJ2ZXIgPGV4YW1wbGUuZnJvbUBleGFtcGxlLmNvbT4=?='
];

// ヘッダーをデコード
$decoded_headers = iconv_mime_decode_headers($headers);

// デコード結果を出力
foreach ($decoded_headers as $header) {
  echo $header['name'] . ': ' . $header['value'] . PHP_EOL;
}

?>

出力例

Subject: コンピューター例題タイトル
From: テストサーバー <[email protected]>

パラメータ

• headers: デコードするメールヘッダーの配列。
• charset: デコード後の文字エンコーディング。省略すると、デフォルトの文字エンコーディングが使用されます。

戻り値

デコードされたヘッダー情報の配列。各要素は、name キーと value キーを持つ連想配列になります。

補足

• iconv_mime_decode_headers() 関数は、メールヘッダーだけでなく、エンコードされた文字列を含む任意の文字列をデコードするために使用できます。
• デコードに失敗した場合、iconv_mime_decode_headers() 関数は FALSE を返します。
• デコードされた文字列は、エンコード方式によって異なる文字コードでエンコードされている場合があります。デコード後に文字コード変換が必要になる場合もあります。

その他のエンコード関連関数

• iconv(): 文字コード変換を行う関数
• mb_decode_mimeheader(): MIME ヘッダーをデコードする関数

PHP iconv_mime_decode_headers 関数：サンプルコード

<?php

$headers = [
  'Subject' => '=?UTF-8?B?Q29tcHV0ZXIgZXhhbXBsZSB0aXRsZQ==?=',
  'From' => '=?UTF-8?B?VGVzdCBTZXJ2ZXIgPGV4YW1wbGUuZnJvbUBleGFtcGxlLmNvbT4=?='
];

$decoded_headers = iconv_mime_decode_headers($headers, 'UTF-8');

foreach ($decoded_headers as $header) {
  echo $header['name'] . ': ' . $header['value'] . PHP_EOL;
}

?>

出力例

Subject: コンピューター例題タイトル
From: テストサーバー <[email protected]>

Quoted-Printable エンコードされた文字列をデコードする

<?php

$encoded_string = '=?UTF-8?Q?This=20is=20a=20test=20string=20with=20=20=A0=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20=20

PHP でエンコードされたメールヘッダーをデコードする他の方法

mb_decode_mimeheader() 関数は、iconv_mime_decode_headers() 関数と同様に、メールヘッダーをデコードするために使用できます。mb_decode_mimeheader() 関数は、マルチバイト文字エンコーディングを扱う mbstring 拡張モジュールを使用します。

<?php

$headers = [
  'Subject' => '=?UTF-8?B?Q29tcHV0ZXIgZXhhbXBsZSB0aXRsZQ==?=',
  'From' => '=?UTF-8?B?VGVzdCBTZXJ2ZXIgPGV4YW1wbGUuZnJvbUBleGFtcGxlLmNvbT4=?='
];

$decoded_headers = mb_decode_mimeheader($headers);

foreach ($decoded_headers as $header) {
  echo $header['name'] . ': ' . $header['value'] . PHP_EOL;
}

?>

imap_mime_header_decode() 関数は、IMAP 拡張モジュールを使用するメールヘッダーをデコードします。この関数は、メールヘッダーをデコードするだけでなく、エンコード方式や文字エンコーディングなどの情報を取得することもできます。

<?php

// IMAP サーバーに接続
$imap = imap_open('{imap.gmail.com:993/imap/ssl}INBOX', 'username', 'password');

// メールヘッダーを取得
$header = imap_fetchheader($imap, 1);

// ヘッダーをデコード
$decoded_headers = imap_mime_header_decode($header);

// デコード結果を出力
foreach ($decoded_headers as $header) {
  echo $header['name'] . ': ' . $header['value'] . PHP_EOL;
}

// IMAP サーバーとの接続を閉じる
imap_close($imap);

?>

自作の関数

上記の方法以外にも、独自の関数を作成してエンコードされたメールヘッダーをデコードすることができます。独自の関数を作成する場合は、RFC 2047 で定義されている MIME ヘッダーエンコーディングの仕様を理解する必要があります。

• 多くの場合、iconv_mime_decode_headers() 関数で十分です。
• マルチバイト文字エンコーディングを扱う場合は、mb_decode_mimeheader() 関数を使用する必要があります。
• メールヘッダーの詳細情報を取得したい場合は、imap_mime_header_decode() 関数を使用する必要があります。
• 独自の要件がある場合は、独自の関数を作成することができます。