iconv_mime_encode()函数—用法及示例

函数名：iconv_mime_encode()

适用版本：PHP 4 >= 4.0.5, PHP 5, PHP 7

用法：iconv_mime_encode() 函数用于编码字符串以便在电子邮件的头部中使用。它可以将字符串编码为符合 MIME 格式的字符串，包括字符编码和传输编码。

语法：

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

参数：

• field_name：邮件头字段的名称，如 "Subject" 或 "From"。
• field_value：要编码的字符串。
• preferences（可选）：一个关联数组，用于指定编码的首选项，包括字符集、传输编码和语言环境。

返回值：返回编码后的字符串，如果编码失败则返回 FALSE。

示例：

<?php
$field_name = "Subject";
$field_value = "这是一个测试邮件";
$preferences = array(
    "scheme" => "Q", // 使用 Quoted-Printable 编码
    "input-charset" => "UTF-8", // 输入字符集为 UTF-8
    "output-charset" => "ISO-8859-1", // 输出字符集为 ISO-8859-1
    "line-length" => 76, // 每行最大长度为 76 个字符
    "line-break-chars" => "\n" // 换行符为 \n
);

$encoded_string = iconv_mime_encode($field_name, $field_value, $preferences);
echo $encoded_string;
?>

输出：

Subject: =?UTF-8?Q?=E8=BF=99=E6=98=AF=E4=B8=80=E4=B8=AA=E6=B5=8B=E8=AF=95=E9=82=AE=E4=BB=B6?=

在上面的示例中，我们将 "这是一个测试邮件" 编码为 MIME 格式的字符串，并指定了字符集为 UTF-8，传输编码为 Quoted-Printable，每行最大长度为 76 个字符，换行符为 \n。最终输出的编码字符串可以用于邮件的头部字段。