Php/docs/function.iconv-mime-decode-headers
iconv_mime_decode_headers
(PHP 5, PHP 7)
iconv_mime_decode_headers — Decodes multiple MIME
header fields at once
Description
iconv_mime_decode_headers
( string $headers
[, int $mode
= 0
[, string|null $encoding
= NULL
]] ) : array|false
Decodes multiple MIME
header fields at once.
Parameters
headers
The encoded headers, as a string.
mode
mode
determines the behaviour in the event iconv_mime_decode_headers() encounters a malformedMIME
header field. You can specify any combination of the following bitmasks.Bitmasks acceptable to iconv_mime_decode_headers() Value Constant Description 1 ICONV_MIME_DECODE_STRICT If set, the given header is decoded in full conformance with the standards defined in » RFC2047. This option is disabled by default because there are a lot of broken mail user agents that don't follow the specification and don't produce correct
MIME
headers.2 ICONV_MIME_DECODE_CONTINUE_ON_ERROR If set, iconv_mime_decode_headers() attempts to ignore any grammatical errors and continue to process a given header.
encoding
The optional
encoding
parameter specifies the character set to represent the result by. If omitted orNULL
, iconv.internal_encoding will be used.
Return Values
Returns an associative array that holds a whole set of
MIME
header fields specified by
headers
on success, or FALSE
if an error occurs during the decoding.
Each key of the return value represents an individual field name and the corresponding element represents a field value. If more than one field of the same name are present, iconv_mime_decode_headers() automatically incorporates them into a numerically indexed array in the order of occurrence.
Changelog
Version | Description |
---|---|
8.0.0 | encoding is nullable now.
|
Examples
Example #1 iconv_mime_decode_headers() example
<?php$headers_string = <<<EOFSubject: =?UTF-8?B?UHLDvGZ1bmcgUHLDvGZ1bmc=?=To: [email protected]: Thu, 1 Jan 1970 00:00:00 +0000Message-Id: <[email protected]>Received: from localhost (localhost [127.0.0.1]) by localhost with SMTP id example for <[email protected]>; Thu, 1 Jan 1970 00:00:00 +0000 (UTC) (envelope-from [email protected])Received: (qmail 0 invoked by uid 65534); 1 Thu 2003 00:00:00 +0000EOF;$headers = iconv_mime_decode_headers($headers_string, 0, "ISO-8859-1");print_r($headers);?>
The above example will output:
Array ( [Subject] => Prüfung Prüfung [To] => [email protected] [Date] => Thu, 1 Jan 1970 00:00:00 +0000 [Message-Id] => <[email protected]> [Received] => Array ( [0] => from localhost (localhost [127.0.0.1]) by localhost with SMTP id example for <[email protected]>; Thu, 1 Jan 1970 00:00:00 +0000 (UTC) (envelope-from [email protected]) [1] => (qmail 0 invoked by uid 65534); 1 Thu 2003 00:00:00 +0000 ) )
See Also
- iconv_mime_decode() - Decodes a MIME header field
- mb_decode_mimeheader() - Decode string in MIME header field
- imap_mime_header_decode() - Decode MIME header elements
- imap_base64() - Decode BASE64 encoded text
- imap_qprint() - Convert a quoted-printable string to an 8 bit string