mb_encode_mimeheader

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_encode_mimeheader — 为 MIME 头编码字符串

说明

mb_encode_mimeheader(
    string $string,
    ?string $charset = null,
    ?string $transfer_encoding = null,
    string $newline = "\r\n",
    int $indent = 0
): string

按 MIME 头编码方案将指定的字符串 string 进行编码。

参数

string: 要编码的 string。它的编码应该和 mb_internal_encoding() 一样。
charset: charset 指定了 str 的字符集名。其默认值由当前的 NLS 设置（mbstring.language）来确定。
transfer_encoding: transfer_encoding 指定了 MIME 的编码方案。它可以是 "B"（Base64）也可以是 "Q"（Quoted-Printable）。如果未设置，将回退为 "B"。
newline: newline 指定了 EOL（行尾）标记，使 mb_encode_mimeheader() 执行了一个换行（» RFC 文档中规定，超过长度的一行将换成多行，当前该长度硬式编码为 74 个字符）。如果没有设定，则回退为 "\r\n" (CRLF)。
indent: 首行缩进（header 里 string 前的字符数目）。

返回值

转换后的字符串版本以 ASCII 形式表达。

更新日志

版本	说明
8.3.0	使用 Quoted-Printable 编码时，不再丢弃 `NUL`（0）字节，而是编码为 `=00`。
8.0.0	`charset` 和 `transfer_encoding` 现在可以为空。

示例

示例 #1 mb_encode_mimeheader() 例子

<?php
$name = "太郎"; // kanji
$mbox = "kru";
$doma = "gtinn.mon";
$addr = '"' . addcslashes(mb_encode_mimeheader($name, "UTF-7", "Q"), '"') . '" <' . $mbox . "@" . $doma . ">";
echo $addr;
?>

以上示例会输出：

"=?UTF-7?Q?+WSqQzg-?=" <kru@gtinn.mon>

注释

注意:
这个函数没有设计成据更高级上下文的中断点来换行（单词边界等）。这个特性将导致意外的空格可能会让原始字符串看上去很乱。

参见

mb_decode_mimeheader() - 解码 MIME 头字段中的字符串