mb_encode_mimeheader
(PHP 4 >= 4.0.6, PHP 5, PHP 7)
mb_encode_mimeheader — Кодирует строку для MIME-заголовка
Описание
$string
, string|null $charset = null
, string|null $transfer_encoding = null
, string $newline = "\r\n"
, int $indent = 0
) : string
Кодирует строку (string) (string)
по схеме кодирования MIME-заголовка.
Список параметров
-
string -
Кодируемая строка типа string. Ее кодировка должна соответствовать mb_internal_encoding().
-
charset -
charsetзадает имя кодировки, в котором представлена строкаstring. По умолчанию значение определяется настройкой NLS (mbstring.language). -
transfer_encoding -
transfer_encodingзадает схему MIME-кодирования. Это может быть либо"B"(Base64), либо"Q"(Quoted-Printable). По умолчанию"B". -
newline -
newlineзадает метку EOL (конец строки, end-of-line), с помощью которой mb_encode_mimeheader() осуществляет завершение строк ("line-folding" - термин » RFC, означающий разделение строк, длина которых превышает заданное значение. Значение длины на данный момент жестко задано как 74 символа). По умолчанию"\r\n"(CRLF). -
indent -
Отступ первой строки (число символов в заголовке перед
string).
Возвращаемые значения
Конвертированная строка (string), преобразованная в ASCII.
Список изменений
| Версия | Описание |
|---|---|
| 8.0.0 |
charset и transfer_encoding
теперь допускают значение null.
|
Примеры
Пример #1 Пример использования mb_encode_mimeheader()
<?php
$name = ""; // kanji
$mbox = "kru";
$doma = "gtinn.mon";
$addr = mb_encode_mimeheader($name, "UTF-7", "Q") . " <" . $mbox . "@" . $doma . ">";
echo $addr;
?>
Примечания
Замечание:
Эта функция не рассчитана на выполнение высокоуровневых разрывов строк (перенос слов целиком и т.п.). Такое поведение может привести к появлению неожидаемых пробелов в исходной строке.