PHP 8.4.2 Released!

    iconv_mime_decode_headers

    (PHP 5, PHP 7, PHP 8)

    iconv_mime_decode_headers — Декодирует несколько полей заголовка MIME

    Описание

    iconv_mime_decode_headers(string $headers, int $mode = 0, ?string $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-битную строку

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей 2 notes

    up
    0
    phpmanual at NOSPAM dot headbank dot co dot uk
    22 days ago
    Just in case this catches anyone else: If your headers string has any leading linebreaks, this function will reject it and return an empty array. If that might apply to your input, sanitise it with ltrim().

    Trailing empty lines are tolerated/ignored.

    Other quirks I noticed just now:

    1. Leading whitespace (" " or "\t") in the *first* line will be included in the header's key name in the returned array. ltrim() will prevent that too.

    2. Leading whitespace in any subsequent header (before the key) will cause that line to be appended to the preceding header's value, as though it were a run-on of that header.
    up
    0
    TheConstructor
    14 years ago
    If you need lower-case header-names (as I read the documentation case is not guranteed) try something like

    <?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");

    $headers = array_combine(array_map("strtolower", array_keys($headers)), array_values($headers));

    print_r($headers);
    ?>
    ＋Добавить
    To Top