iconv_mime_decode_headers
(PHP 5, PHP 7)
iconv_mime_decode_headers — Декодирует несколько полей заголовка MIME
Описание
$headers
, int $mode
= 0
, string|null $encoding
= null
) : array|false
Декодирует несколько полей заголовка MIME
за один раз.
Список параметров
-
headers
-
Закодированные заголовки в виде строки.
-
mode
-
Параметр
mode
определяет поведение, если iconv_mime_decode_headers() обнаружит неправильное поле заголовкаMIME
. Можно указать любую комбинацию следующих битовых масок.Битовые маски iconv_mime_decode_headers() Значение Константа Описание 1 ICONV_MIME_DECODE_STRICT Строго следовать стандартам, определённым в » RFC2047. Эта опция по умолчанию отключена, так как много проприетарных программ электронной почты не следуют стандартам и создают некорректные заголовки MIME
.2 ICONV_MIME_DECODE_CONTINUE_ON_ERROR Если установлена, iconv_mime_decode_headers() будет пытаться игнорировать любые ошибки и продолжать обработку текущего заголовка. -
encoding
-
Необязательный параметр
encoding
указывает кодировку, в которой будет представлен результат. Если опущен, будет использовано значение директивы iconv.internal_encoding.
Возвращаемые значения
В случае успеха возвращает ассоциативный массив с полями
MIME
-заголовков, указанных параметром
headers
, или false
в случае ошибки.
Каждый ключ элемента возвращаемого массива представляет собой отдельное имя поля, а сам элемент - его значение. Если в заголовке существует несколько полей с одинаковым именем, iconv_mime_decode_headers() автоматически помещает их в подмассив с числовыми индексами в порядке их обработки.
Список изменений
Версия | Описание |
---|---|
8.0.0 |
encoding теперь допускает значение null.
|
Примеры
Пример #1 Пример использования iconv_mime_decode_headers()
<?php
$headers_string = <<<EOF
Subject: =?UTF-8?B?UHLDvGZ1bmcgUHLDvGZ1bmc=?=
To: example@example.com
Date: Thu, 1 Jan 1970 00:00:00 +0000
Message-Id: <example@example.com>
Received: from localhost (localhost [127.0.0.1]) by localhost
with SMTP id example for <example@example.com>;
Thu, 1 Jan 1970 00:00:00 +0000 (UTC)
(envelope-from example-return-0000-example=example.com@example.com)
Received: (qmail 0 invoked by uid 65534); 1 Thu 2003 00:00:00 +0000
EOF;
$headers = iconv_mime_decode_headers($headers_string, 0, "ISO-8859-1");
print_r($headers);
?>
Результат выполнения данного примера:
Array ( [Subject] => Prüfung Prüfung [To] => example@example.com [Date] => Thu, 1 Jan 1970 00:00:00 +0000 [Message-Id] => <example@example.com> [Received] => Array ( [0] => from localhost (localhost [127.0.0.1]) by localhost with SMTP id example for <example@example.com>; Thu, 1 Jan 1970 00:00:00 +0000 (UTC) (envelope-from example-return-0000-example=example.com@example.com) [1] => (qmail 0 invoked by uid 65534); 1 Thu 2003 00:00:00 +0000 ) )
Смотрите также
- iconv_mime_decode() - Декодирует поле MIME-заголовка
- mb_decode_mimeheader() - Декодирует строку в MIME-заголовке
- imap_mime_header_decode() - Декодировать элементы заголовка
- imap_base64() - Декодировать текст закодированный BASE64
- imap_qprint() - Преобразовать строку из формата "quoted-printable" в 8-битную строку