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

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

iconv_mime_encode関数は、MIME（Multipurpose Internet Mail Extensions）ヘッダーで使用するために、文字列を特定の形式にエンコードする関数です。この関数は主に、電子メールの件名や差出人名といったヘッダー情報に、日本語などの非ASCII文字（多バイト文字）が含まれる場合に利用されます。メールシステムやウェブアプリケーションにおいて、これらの多バイト文字が正しく表示されず、いわゆる「文字化け」が発生するのを防ぐ目的で使用されます。

具体的には、入力された文字列を、指定された文字セット（例: UTF-8）とエンコード方式（Base64またはQuoted-Printable）に基づいて、国際標準であるMIMEエンコード形式、例えば「=?UTF-8?B?エンコードされたテキスト?=」のような形式に変換します。これにより、様々なメールクライアントやシステムが、エンコードされたヘッダー情報を正しく解釈し、元の多バイト文字を適切に表示できるようになります。

この関数は、エンコード対象の文字列だけでなく、その文字列の元の文字セットや、出力時に使用する文字セット、エンコード方式、さらには出力される行の最大長や改行文字など、詳細なオプションを指定することが可能です。これにより、特定の要件や環境に合わせて、柔軟なMIMEエンコード処理を実現できます。国際化されたアプリケーション開発において、ヘッダー情報の正確な伝達と表示を保証するために、非常に重要な役割を果たす関数です。

基本的な使い方

構文(syntax)

<?php

$field_name = "Subject";
$field_value = "これはテストの件名です。";
$options = [
    "input-charset"  => "UTF-8",
    "output-charset" => "UTF-8",
    "scheme"         => "B", // Base64エンコーディングを指定
];

$encoded_header = iconv_mime_encode($field_name, $field_value, $options);

echo $encoded_header;

?>

引数(parameters)

string $field_name, string $field_value, array $options = []

PHP:

string $field_name: エンコードするフィールド名（例: "Subject", "From"）
string $field_value: エンコードするフィールドの値
array $options = []: エンコードのオプションを指定する連想配列

戻り値(return)

string|false

エンコードされたMIMEヘッダー文字列、またはエラー発生時にはfalseを返します。