(PHP 5, PHP 7)
iconv_mime_encode — Сжимает поле MIME-заголовка
$field_name
, string $field_value
[, array $preferences = NULL
] )Сжимает поле MIME-заголовка и представляет его строкой вида:
Subject: =?ISO-8859-1?Q?Pr=FCfung_f=FCr?= Entwerfen von einer MIME kopfzeile
field_nameИмя поля.
field_valueЗначение поля.
preferences
Есть возможность контролировать поведение функции
iconv_mime_encode() посредством передачи массива с
настройками в качестве третьего аргумента
preferences. Возможные значения этого массива,
поддерживаемые функцией iconv_mime_encode(),
перечислены ниже. Обратите внимание, что имена элементов чувствительны
к регистру символов.
| Элемент | Тип | Описание | Значение по умолчанию | Пример |
|---|---|---|---|---|
| scheme | string | Задает, каким образом закодировать значение поля. Значением этого элемента может быть либо "B", либо "Q". "B" означает схему кодирования base64, а "Q" - quoted-printable. | B | B |
| input-charset | string |
Задает, в какой кодировке представлены аргументы
field_name и
field_value. Если не задан,
iconv_mime_encode() предполагает, что набор символов
указан в ini-настройке iconv.internal_encoding.
|
iconv.internal_encoding | ISO-8859-1 |
| output-charset | string | Задает набор символов, в котором будет представлен результирующий MIME-заголовок. | iconv.internal_encoding | UTF-8 |
| line-length | integer | Устанавливает максимальную длину строк заголовка. Если результирующий заголовок окажется длиннее этой величины, функция его разрежет на несколько строк в соответствии с » Форматом интернет сообщений - RFC2822. Если не задан, эта длина будет установлена 76 символов. | 76 | 996 |
| line-break-chars | string | Задает последовательность символов, которые будут использоваться для завершения "разрезанных" строк заголовка, если заголовок окажется длиннее одной строки. Если не задан, будут использоваться символы "\r\n" (CR LF). Обратите внимание, что этот аргумент всегда представляется в ASCII кодировке, вне зависимости от значения input-charset. | \r\n | \n |
Возвращает закодированное MIME поле в случае успеха
или FALSE в случае ошибки.
Пример #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=20Pr=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);
?>