(PHP 5, PHP 7)
iconv_mime_decode_headers — Декодирует несколько полей заголовка MIME
$encoded_headers
[, int $mode
= 0
[, string $charset
= ini_get("iconv.internal_encoding")
]] )Декодирует несколько полей заголовка MIME за один раз.
encoded_headers
Не раскодированные заголовки в виде строки.
mode
Параметр mode
определяет поведение, если
iconv_mime_decode_headers() обнаружит
неправильное поле заголовка MIME.
Можно указать любую комбинацию следующих битовых масок.
Значение | Константа | Описание |
---|---|---|
1 | ICONV_MIME_DECODE_STRICT | Строго следовать стандартам, определённым в » RFC2047. Эта опция по умолчанию отключена, так как, к сожалению, много проприетарных программ электронной почты не следуют стандартам, и генерируют некорректные заголовки MIME. |
2 | ICONV_MIME_DECODE_CONTINUE_ON_ERROR | Если установлена, iconv_mime_decode_headers() будет пытаться игнорировать любые ошибки и продолжать обработку текущего заголовка. |
charset
Необязательный параметр charset
указывает
кодировку, в которой будет представлен результат. Если опущен,
будет использовано значение директивы
iconv.internal_encoding.
В случае успеха возвращает ассоциативный массив с полями
MIME-заголовков, указанных параметром
encoded_headers
, или FALSE
в случае ошибки.
Каждый ключ элемента возвращаемого массива представляет собой отдельное имя поля, а сам элемент - его значение. Если в заголовке существует несколько полей с одинаковым именем, iconv_mime_decode_headers() автоматически помещает их в подмассив с числовыми индексами в порядке их обработки.
Пример #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 ) )