iconv_mime_encode

(PHP 5, PHP 7)

iconv_mime_encode - 撰写MIME标题字段

描述

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

撰写并返回一个代表有效MIME标头字段的字符串，如下所示：

Subject: =?ISO-8859-1?Q?Pr=FCfung_f=FCr?= Entwerfen von einer MIME kopfzeile

在上面的例子中，“Subject”是字段名称，以“=？ISO-8859-1？...”开头的部分是字段值。

参数

field_name

字段名称。

field_value

字段值。

preferences

您可以通过指定包含可选第三个参数的配置项的关联数组来控制iconv_mime_encode()的行为preferences。下面列出了iconv_mime_encode()支持的项目。请注意，项目名称被区分大小写。

项目	类型	描述	默认值	例
方案	串	指定通过编码字段值的方法。该项目的值可以是“B”或“Q”，其中“B”代表base64编码方案，“Q”代表引用可打印的编码方案。	乙	乙
输入字符集	串	指定显示第一个参数field_name和第二个参数field_value的字符集。如果没有给出，iconv_mime_encode()假定这些参数在iconv.internal_encoding ini设置中呈现给它。	iconv.internal_encoding	ISO-8859-1
输出字符集	串	指定用于组成MIME标头的字符集。	iconv.internal_encoding	UTF-8
线长度的	整数	指定标题行的最大长度。根据»RFC2822 - 互联网信息格式，结果的头部被“折叠”成一组多行，以防止结果的头部字段长于此参数的值。如果没有给出，长度将被限制为76个字符。	76	996
换行，字符	串	在长标题字段上执行“折叠”时，指定要附加到每行的字符序列作为行尾符号。如果没有给出，则默认为“\ r \ n”（CR LF）。请注意，无论input-charset的值如何，此参数始终都视为ASCII字符串。	\ r \ n	\ n

返回值

成功时返回编码的MIME字段，或者FALSE在编码期间发生错误。

示例

Example #1 iconv_mime_encode() example

<?php
$preferences = array(
    "input-charset" => "ISO-8859-1",
    "output-charset" => "UTF-8",
    "line-length" => 76,
    "line-break-chars" => "\n"

$preferences["scheme"] = "Q";
// This yields "Subject: =?UTF-8?Q?Pr=C3=BCfung=20Pr=C3=BCfung?="
echo iconv_mime_encode("Subject", "Prüfung Prüfung", $preferences

$preferences["scheme"] = "B";
// This yields "Subject: =?UTF-8?B?UHLDvGZ1bmcgUHLDvGZ1bmc=?="
echo iconv_mime_encode("Subject", "Prüfung Prüfung", $preferences
?>

另请参阅

imap_binary() - 将8位字符串转换为base64字符串

mb_encode_mimeheader() - 为MIME头编码字符串

imap_8bit() - 将8位字符串转换为带引号的可打印字符串

quoted_printable_encode() - 将8位字符串转换为带引号的可打印字符串

← iconv_mime_decode

iconv_set_encoding →