cvs: phpdoc-fr /reference/iconv/functions iconv-mime-decode-headers.xml
| From: | Damien Seguy | 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
-->