php man page for iconv_mime_decode_headers

ICONV_MIME_DECODE_HEADERS(3)						 1					      ICONV_MIME_DECODE_HEADERS(3)

iconv_mime_decode_headers - Decodes multiple MIMEheader fields at once

SYNOPSIS
       array iconv_mime_decode_headers (string	$encoded_headers, [int	$mode], [string  $charset = ini_get("iconv.internal_encoding")])

DESCRIPTION
	Decodes multiple MIME header fields at once.

PARAMETERS
	      o $encoded_headers
		- The encoded headers, as a string.

	      o $mode
		-$mode	determines the behaviour in the event iconv_mime_decode_headers(3) encounters a malformed MIME header field. You can spec-
		ify any combination of the following bitmasks.

	      Bitmasks acceptable to iconv_mime_decode_headers(3)

	      +------+--------------------------------------+---+
	      |Value |					    |	|
	      |      |					    |	|
	      |      |		     Constant		    |	|
	      |      |					    |	|
	      |      |		   Description		    |	|
	      |      |					    |	|
	      +------+--------------------------------------+---+
	      |  1   |					    |	|
	      |      |					    |	|
	      |      |	     ICONV_MIME_DECODE_STRICT	    |	|
	      |      |					    |	|
	      |      |	If set, the given header is decoded |	|
	      |      | in  full  conformance with the stan- |	|
	      |      | dards  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_head- |	|
	      |      | ers(3) attempts to ignore any  gram- |	|
	      |      | matical	 errors   and  continue  to |	|
	      |      | process a given header.		    |	|
	      |      |					    |	|
	      +------+--------------------------------------+---+
	      o $charset
		- The optional $charset parameter specifies the character set to represent the result by. If omitted, iconv.internal_encoding will
		be used.

RETURN VALUES
	Returns  an  associative array that holds a whole set of MIME header fields specified by $encoded_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(3) automatically incorporates them into a numerically indexed array in the
       order of occurrence.

EXAMPLES
       Example #1

	      iconv_mime_decode_headers(3) example

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

	      The above example will output:

	      Array
	      (
		  [Subject] => Prufung Prufung
		  [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
		      )

	      )

SEE ALSO
       iconv_mime_decode(3), mb_decode_mimeheader(3), imap_mime_header_decode(3), imap_base64(3), imap_qprint(3).

PHP Documentation Group 											      ICONV_MIME_DECODE_HEADERS(3)