cvs: phpdoc-fr /reference/iconv/functions iconv-mime-decode-headers.xml

From: Date: Sat, 20 Mar 2004 12:56:05 +0000
Subject: cvs: phpdoc-fr /reference/iconv/functions iconv-mime-decode-headers.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-2050@lists.php.net to get a copy of this message
dams Sat Mar 20 07:56:05 2004 EDT Added files: /phpdoc-fr/reference/iconv/functions iconv-mime-decode-headers.xml Log: initial translation http://cvs.php.net/co.php/phpdoc-fr/reference/iconv/functions/iconv-mime-decode-headers.xml?r=1.1&p=1 Index: phpdoc-fr/reference/iconv/functions/iconv-mime-decode-headers.xml +++ phpdoc-fr/reference/iconv/functions/iconv-mime-decode-headers.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <refentry id="function.iconv-mime-decode-headers"> <refnamediv> <refname>iconv_mime_decode_headers</refname> <refpurpose> Décode des entêtes <literal>MIME</literal> multiples </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>iconv_mime_decode_headers</methodname> <methodparam><type>string</type><parameter>encoded_headers</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> <function>iconv_mime_decode_headers</function> retourne un tableau associatif qui contient les entêtes <literal>MIME</literal> spécifiés par le paramètre <parameter>encoded_headers</parameter>, ou bien &false; si une erreur survient durant le décodage. </para> <para> Chaque clé du tableau retourné contient un nom d'entête distinct, et sa valeur correspondante. Si plusieurs champs ont le même nom, <function>iconv_mime_decode_headers</function> fera de ce champs un tableau indexé, avec les valeurs dans leur ordre d'apparance. </para> <para> <parameter>mode</parameter> détermine le comportement de la fonction, si <function>iconv_mime_decode_headers</function> rencontre un entête <literal>MIME</literal> maformé. Vous pouvez spécifier une combinaison des optiosn suivantes : <table> <title>Options de <function>iconv_mime_decode_headers</function></title> <tgroup cols="3"> <thead> <row> <entry>Valeur</entry> <entry>Constante</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry>1</entry> <entry><constant>ICONV_MIME_DECODE_STRICT</constant></entry> <entry> Si utilisée, les entêtes sont décodés en respectant scrupuleusement le standard de la <ulink url="&url.rfc;2047">RFC2047</ulink>. Cette option est désactivée par défaut, car il y a de nombreux clients mails qui ne suivent pas ces spécifications, et qui ne produisent pas d'entêtes <literal>MIME</literal> corrects. </entry> </row> <row> <entry>2</entry> <entry><constant>ICONV_MIME_DECODE_CONTINUE_ON_ERROR</constant></entry> <entry> Si cette option est activée, <function>iconv_mime_decode_headers</function> tente d'ignorer les erreurs de syntaxe, et continue de traiter l'entête donné. </entry> </row> </tbody> </tgroup> </table> </para> <para> Le paramètre optionnel <parameter>charset</parameter> spécifie le jeu de caractères utilisé pour représenter le résultat. S'il est omis, le jeu définit dans le fichier &php.ini; <link linkend="iconv.configuration">iconv.internal_charset</link> est utilisé. </para> <example> <title>Exemple avec <function>iconv_mime_decode_headers</function></title> <programlisting role="php"> <?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); ?> </programlisting> <simpara> Le résultat de ce script est : </simpara> <screen> 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 ) ) </screen> </example> <para> Voir aussi <function>iconv_mime_decode</function>, <function>mb_decode_mimeheader</function>, <function>imap_mime_header_decode</function>, <function>imap_base64</function> et <function>imap_qprint</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->

« previous php.doc.fr (#2050) next »