(PHP 5, PHP 7, PHP 8)
iconv_mime_decode_headers — Декодирует несколько полей заголовка MIME
$headers
, int $mode
= 0, ?string $encoding
= null
): array|false
Декодирует несколько полей заголовка MIME
за один раз.
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() будет пытаться игнорировать любые ошибки и продолжать обработку текущего заголовка. |
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 ) )