iconv_mime_encode

PHP マニュアル
前のページ		次のページ

説明

string iconv_mime_encode ( string field_name, string field_value [, array preferences] )

有効な MIME ヘッダフィールドを作成し、返します。これは以下のような形式になります。
Subject: =?ISO-8859-1?Q?Pr=FCfung_f=FCr?= Entwerfen von einer MIME kopfzeile
上の例では "Subject" がフィールド名、"=?ISO-8859-1?..." で始まる部分がフィールドの値となります。

iconv_mime_encode() の振る舞いを変更するには、オプションの第 3 パラメータ preferences に設定項目を含む連想配列を指定します。 iconv_mime_encode() でサポートされている項目は以下のとおりです。項目名の大文字・小文字は区別されることに注意してください。

表 1. iconv_mime_encode() でサポートされる設定項目

項目	型	説明	デフォルト値	例
scheme	boolean	フィールドの値のエンコード方法を指定します。"B" か "Q" のどちらかを指定することになるでしょう。"B" は `base64` エンコードを、また "Q" は `quoted-printable` エンコードを表します。	B	B
input-charset	string	第 1 パラメータ `field_name` と第 2 パラメータ `field_value` の文字セットを指定します。指定されなかった場合は、iconv_mime_encode() は ini 設定 iconv.internal_charset であると家庭します。	iconv.internal_charset	ISO-8859-1
output-charset	string	`MIME` ヘッダを作成する文字セットを指定します。指定されなかった場合は、`input-charset` と同じ値が用いられます。	`input-charset` と同じ値	UTF-8
line-length	integer	ヘッダ行の長さの最大値を指定します。もし結果がこの値より長くなった場合は、 RFC2822 - Internet Message Format に基づいてヘッダを "折りたたんで" 複数行に分割します。指定されなかった場合は、長さは 76 文字に限定されます。	76	996
line-break-chars	string	長いヘッダフィールドに対して "折りたたみ" 処理が行われる場合に個々の行の後ろに付加される文字列を指定します。指定されなかった場合は、"\r\n" （`CR` `LF`）が用いられます。このパラメータは、`input-charset` の値にかかわらず常に ASCII 文字列として扱われることに注意してください。	\r\n	\n

例 1. iconv_mime_encode() の例:


<?php
$preferences = array(
    "input-charset" => "ISO-8859-1",
    "output-charset" => "UTF-8",
    "line-length" => 76,
    "line-break-chars" => "\n"
);
$preferences["scheme"] = "Q";
// この結果は "Subject: =?UTF-8?Q?Pr=C3=BCfung_Pr=C3=BCfung?=" となります。
echo iconv_mime_encode("Subject", "Prüfung Prüfung", $preferences);

$preferences["scheme"] = "B";
// この結果は "Subject: =?UTF-8?B?UHLDvGZ1bmcgUHLDvGZ1bmc=?=" となります。
echo iconv_mime_encode("Subject", "Prüfung Prüfung", $preferences);
?>

imap_binary()、 mb_encode_mimeheader() および imap_8bit() も参照ください。

前のページ	ホーム	次のページ
iconv_mime_decode	上に戻る	iconv_set_encoding