cvs: phpdoc-fr /reference/imap/functions imap-8bit.xml imap-alerts.xml imap-append.xml imap-base64.xml imap-binary.xml imap-body.xml
imap-bodystruct.xml imap-check.xml imap-clearflag-full.xml imap-close.xml imap-createmailbox.xml imap-delete.xml imap-deletemailbox.xml
imap-errors.xml imap-expunge.xml imap-fetch-overview.xml imap-fetchbody.xml imap-fetchheader.xml imap-fetchstructure.xml imap-get-quota.xml
imap-get-quotaroot.xml imap-getacl.xml imap-getmailboxes.xml imap-getsubscribed.xml

yannick Mon Jan 29 17:23:37 2007 UTC Modified files: /phpdoc-fr/reference/imap/functions imap-8bit.xml imap-alerts.xml imap-append.xml imap-base64.xml imap-binary.xml imap-bodystruct.xml imap-body.xml imap-check.xml imap-clearflag-full.xml imap-close.xml imap-createmailbox.xml imap-deletemailbox.xml imap-delete.xml imap-errors.xml imap-expunge.xml imap-fetchbody.xml imap-fetchheader.xml imap-fetch-overview.xml imap-fetchstructure.xml imap-getacl.xml imap-getmailboxes.xml imap-get-quotaroot.xml imap-get-quota.xml imap-getsubscribed.xml Log: sync with EN

http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-8bit.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-8bit.xml diff -u phpdoc-fr/reference/imap/functions/imap-8bit.xml:1.11 phpdoc-fr/reference/imap/functions/imap-8bit.xml:1.12 --- phpdoc-fr/reference/imap/functions/imap-8bit.xml:1.11 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-8bit.xml Mon Jan 29 17:23:37 2007 @@ -1,36 +1,54 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-8bit"> - <refnamediv> - <refname>imap_8bit</refname> - <refpurpose> - Convertit une chaîne à 8 bits en une chaîne - à guillemets - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>imap_8bit</methodname> - <methodparam><type>string</type><parameter>string</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_8bit</function> convertit la chaîne à 8 bits - en une chaîne à guillemets - (selon la <ulink url="&url.rfc;2045">RFC 2045</ulink>, Section 6.7). - </para> - <para> - <function>imap_8bit</function> retourne une chaîne à - guillemets. - </para> - <para> - Voir aussi - <function>imap_qprint</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-8bit"> + <refnamediv> + <refname>imap_8bit</refname> + <refpurpose>Convertit une chaîne à 8 bits en une chaîne à guillemets</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>imap_8bit</methodname> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + </methodsynopsis> + <para> + Convertit la chaîne à 8 bits en une chaîne à guillemets + (selon la <ulink url="&url.rfc;2045">RFC 2045</ulink>, Section 6.7). + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>string</parameter></term> + <listitem> + <para> + La chaîne 8 bits à convertir + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne une chaîne à guillemets. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_qprint</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -51,4 +69,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-alerts.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-alerts.xml diff -u phpdoc-fr/reference/imap/functions/imap-alerts.xml:1.9 phpdoc-fr/reference/imap/functions/imap-alerts.xml:1.10 --- phpdoc-fr/reference/imap/functions/imap-alerts.xml:1.9 Tue May 2 23:07:36 2006 +++ phpdoc-fr/reference/imap/functions/imap-alerts.xml Mon Jan 29 17:23:37 2007 @@ -1,34 +1,46 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.5 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.7 Maintainer: jsgoupil Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-alerts"> - <refnamediv> - <refname>imap_alerts</refname> - <refpurpose> - Retourne toutes les alertes - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>imap_alerts</methodname> - <void/> - </methodsynopsis> - <para> - Cette fonction retourne un tableau de tous les messages d'alerte - <acronym>IMAP</acronym> générés depuis le dernier appel à - <function>imap_alerts</function> ou depuis le début de la page. Retourne - &false; si aucun message d'alerte n'est disponible. - Lorsque <function>imap_alerts</function> est appelée, la pile d'alertes - est vidée. Les spécifications IMAP requièrent que ces messages soient - passés à l'utilisateur. - </para> - <para> - Voyez aussi <function>imap_errors</function> - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-alerts"> + <refnamediv> + <refname>imap_alerts</refname> + <refpurpose>Retourne toutes les alertes</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>imap_alerts</methodname> + <void/> + </methodsynopsis> + <para> + Retourne un tableau de tous les messages d'alerte + <acronym>IMAP</acronym> générés depuis le dernier appel à + <function>imap_alerts</function> ou depuis le début de la page. + </para> + <para> + Lorsque <function>imap_alerts</function> est appelée, la pile d'alertes + est vidée. Les spécifications IMAP requièrent que ces messages soient + passés à l'utilisateur. + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau contenant tous les messages d'alerte IMAP générés ou + &false; si aucun message n'alerte n'est disponible. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_errors</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -49,4 +61,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-append.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-append.xml diff -u phpdoc-fr/reference/imap/functions/imap-append.xml:1.11 phpdoc-fr/reference/imap/functions/imap-append.xml:1.12 --- phpdoc-fr/reference/imap/functions/imap-append.xml:1.11 Tue Jan 24 18:05:43 2006 +++ phpdoc-fr/reference/imap/functions/imap-append.xml Mon Jan 29 17:23:37 2007 @@ -1,57 +1,91 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.10 Maintainer: didou Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-append"> - <refnamediv> - <refname>imap_append</refname> - <refpurpose> - Ajoute une chaîne dans une boîte aux lettres - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imap_append</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>mbox</parameter></methodparam> - <methodparam><type>string</type><parameter>message</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>options</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_append</function> ajoute un message dans la boîte - aux lettres <parameter>mbox</parameter>. Si l'argument - <parameter>options</parameter> est utilisé, - <parameter>options</parameter> sera aussi écrit dans la boîte - aux lettres. - </para> - <para> - &return.success; - </para> - <para> - Lors des échanges avec le serveur Cyrus IMAP, vous devrez utiliser - "\r\n" comme terminaison de ligne, à la place de "\n" ou - l'opération échouera. - </para> - <para> - <example> - <title>Exemple avec <function>imap_append</function></title> - <programlisting role="php"> + +<refentry id="function.imap-append"> + <refnamediv> + <refname>imap_append</refname> + <refpurpose>Ajoute une message dans une boîte aux lettres</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imap_append</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> + <methodparam><type>string</type><parameter>message</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <para> + Ajoute un message dans la boîte aux lettres <parameter>mbox</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>mailbox</parameter></term> + <listitem> + <para> + Le nom de la boîte aux lettres, voir la documentation sur la fonction + <function>imap_open</function> pour plus d'informations + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>message</parameter></term> + <listitem> + <para> + Le message à ajouter, sous la forme d'une &string; + </para> + <para> + Lors des échanges avec le serveur Cyrus IMAP, vous devrez utiliser + "\r\n" comme terminaison de ligne, à la place de "\n" ou + l'opération échouera. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> + <listitem> + <para> + Si fourni, le paramètre <parameter>options</parameter> sera également + écrit dans la boîte <parameter>mailbox</parameter> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_append</function></title> + <programlisting role="php"> <![CDATA[ <?php - $stream = imap_open("{imap.example.org}INBOX.Drafts", "username", "password"); $check = imap_check($stream); -echo "Nombre de message avant ajout : ". $check->Nmsgs . "\n"; +echo "Msg Count before append: ". $check->Nmsgs . "\n"; imap_append($stream, "{imap.example.org}INBOX.Drafts" - , "From: moi@mon.hote\r\n" - . "To: toi@ton.hote\r\n" + , "From: me@example.com\r\n" + . "To: you@example.com\r\n" . "Subject: test\r\n" . "\r\n" - . "Ceci est un message de test. Ignorez le\r\n" - ); + . "Ceci est un message de test. Ignorez le.\r\n" + ); $check = imap_check($stream); echo "Nombre de messages après ajout : ". $check->Nmsgs . "\n"; @@ -59,11 +93,11 @@ imap_close($stream); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-base64.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-base64.xml diff -u phpdoc-fr/reference/imap/functions/imap-base64.xml:1.10 phpdoc-fr/reference/imap/functions/imap-base64.xml:1.11 --- phpdoc-fr/reference/imap/functions/imap-base64.xml:1.10 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-base64.xml Mon Jan 29 17:23:37 2007 @@ -1,31 +1,56 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-base64"> - <refnamediv> - <refname>imap_base64</refname> - <refpurpose>Décode un texte encodé en BASE64</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>imap_base64</methodname> - <methodparam><type>string</type><parameter>text</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_base64</function> décode un texte encodé - en BASE64 (voir la <ulink url="&url.rfc;2045">RFC2045</ulink>, - Section 6.8). Le texte décodé est retourné sous la forme - d'une chaîne - </para> - <para> - Voir aussi <function>imap_binary</function>, - <function>base64_encode</function> et - <function>base64_decode</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-base64"> + <refnamediv> + <refname>imap_base64</refname> + <refpurpose>Décode un texte encodé en BASE64</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>imap_base64</methodname> + <methodparam><type>string</type><parameter>text</parameter></methodparam> + </methodsynopsis> + <para> + Décode le texte <parameter>text</parameter> encodé en BASE64. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>text</parameter></term> + <listitem> + <para> + Le texte à décoder + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le texte décodé, sous la forme d'une &string;. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_binary</function></member> + <member><function>base64_encode</function></member> + <member><function>base64_decode</function></member> + <member><ulink url="&url.rfc;2045">RFC2045</ulink>, Section 6.8</member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -46,4 +71,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-binary.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-binary.xml diff -u phpdoc-fr/reference/imap/functions/imap-binary.xml:1.10 phpdoc-fr/reference/imap/functions/imap-binary.xml:1.11 --- phpdoc-fr/reference/imap/functions/imap-binary.xml:1.10 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-binary.xml Mon Jan 29 17:23:37 2007 @@ -1,34 +1,55 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-binary"> - <refnamediv> - <refname>imap_binary</refname> - <refpurpose> - Convertit une chaîne à 8 bits en une chaîne à base64 - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>imap_binary</methodname> - <methodparam><type>string</type><parameter>string</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_binary</function> convertit la chaîne à - 8 bits <parameter>string</parameter> en une chaîne à base64 - (selon la <ulink url="&url.rfc;2045">RFC2045</ulink>, Section 6.8). - </para> - <para> - <function>imap_binary</function> retourne la chaîne codée. - </para> - <para> - Voir aussi - <function>imap_base64</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-binary"> + <refnamediv> + <refname>imap_binary</refname> + <refpurpose>Convertit une chaîne à 8 bits en une chaîne à base64</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>imap_binary</methodname> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + </methodsynopsis> + <para> + Convertit la chaîne à 8 bits <parameter>string</parameter> + en une chaîne à base64 (selon la <ulink url="&url.rfc;2045">RFC2045</ulink>, + Section 6.8). + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>string</parameter></term> + <listitem> + <para> + La chaîne 8 bits + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne la chaîne encodée en base64. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_base64</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -49,4 +70,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-bodystruct.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-bodystruct.xml diff -u phpdoc-fr/reference/imap/functions/imap-bodystruct.xml:1.6 phpdoc-fr/reference/imap/functions/imap-bodystruct.xml:1.7 --- phpdoc-fr/reference/imap/functions/imap-bodystruct.xml:1.6 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-bodystruct.xml Mon Jan 29 17:23:37 2007 @@ -1,27 +1,138 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-bodystruct"> - <refnamediv> - <refname>imap_bodystruct</refname> - <refpurpose> - Lit la structure d'une section du corps d'un mail - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>object</type><methodname>imap_bodystruct</methodname> - <methodparam><type>resource</type><parameter>stream_id</parameter></methodparam> - <methodparam><type>int</type><parameter>msg_no</parameter></methodparam> - <methodparam><type>string</type><parameter>section</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - </refsect1> - </refentry> + +<refentry id='function.imap-bodystruct'> + <refnamediv> + <refname>imap_bodystruct</refname> + <refpurpose>Lit la structure d'une section du corps d'un mail</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>object</type><methodname>imap_bodystruct</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>int</type><parameter>msg_number</parameter></methodparam> + <methodparam><type>string</type><parameter>section</parameter></methodparam> + </methodsynopsis> + <para> + Lit la structure d'une section spécifié du corps d'un mail. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>msg_number</parameter></term> + <listitem> + <para> + Le numéro du message + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>section</parameter></term> + <listitem> + <para> + La section du corps à lire + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne les informations dans un objet contenant les propriétés suivantes : + <itemizedlist> + <listitem> + <simpara> + type - + </simpara> + </listitem> + <listitem> + <simpara> + encoding - + </simpara> + </listitem> + <listitem> + <simpara> + ifsubtype - + </simpara> + </listitem> + <listitem> + <simpara> + subtype - + </simpara> + </listitem> + <listitem> + <simpara> + ifdescription - + </simpara> + </listitem> + <listitem> + <simpara> + description - + </simpara> + </listitem> + <listitem> + <simpara> + ifid - + </simpara> + </listitem> + <listitem> + <simpara> + id - + </simpara> + </listitem> + <listitem> + <simpara> + lines - nombre de lignes + </simpara> + </listitem> + <listitem> + <simpara> + bytes - taille du message, en octets + </simpara> + </listitem> + <listitem> + <simpara> + ifdisposition - + </simpara> + </listitem> + <listitem> + <simpara> + disposition - + </simpara> + </listitem> + <listitem> + <simpara> + ifdparameters - + </simpara> + </listitem> + <listitem> + <simpara> + dparameters - + </simpara> + </listitem> + <listitem> + <simpara> + ifparameters - + </simpara> + </listitem> + <listitem> + <simpara> + parameters - + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -42,4 +153,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-body.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-body.xml diff -u phpdoc-fr/reference/imap/functions/imap-body.xml:1.10 phpdoc-fr/reference/imap/functions/imap-body.xml:1.11 --- phpdoc-fr/reference/imap/functions/imap-body.xml:1.10 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-body.xml Mon Jan 29 17:23:37 2007 @@ -1,57 +1,83 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-body"> - <refnamediv> - <refname>imap_body</refname> - <refpurpose>Lit le corps d'un message</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>imap_body</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>int</type><parameter>msg_number</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_body</function> retourne le corps du message numéro - <parameter>msg_number</parameter> de la boîte aux lettres courante. - </para> - <para> - Le paramètre <parameter>options</parameter> est un masque qui peut - contenir les valeurs suivantes : - <itemizedlist> - <listitem> - <simpara> - <constant>FT_UID</constant> - <parameter>msg_number</parameter> - est un UID - </simpara> - </listitem> + +<refentry id="function.imap-body"> + <refnamediv> + <refname>imap_body</refname> + <refpurpose>Lit le corps d'un message</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>imap_body</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>int</type><parameter>msg_number</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <para> + <function>imap_body</function> retourne le corps du message numéro + <parameter>msg_number</parameter> de la boîte aux lettres courante. + </para> + <para> + <function>imap_body</function> va retourner une copie brute du corps du + message. Pour extraire les sous-parties MIME du message, utilisez + <function>imap_fetchstructure</function> pour analyser la structure, + et <function>imap_fetchbody</function> pour extraire une copie d'une + des sous-partie. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>msg_number</parameter></term> <listitem> - <simpara> - <constant>FT_PEEK</constant> - Ne pas lever le drapeau \Seen - (Message lu) s'il n'est pas déjà levé. - </simpara> + <para> + Le numéro du message + </para> </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> <listitem> - <simpara> - <constant>FT_INTERNAL</constant> - La chaîne renvoyée est au - format interne, et ne va pas canoniser les CRLF. - </simpara> + <para> + Le paramètre <parameter>options</parameter> optionnel est un masque qui peut + contenir les valeurs suivantes : + <itemizedlist> + <listitem> + <simpara> + <constant>FT_UID</constant> - <parameter>msg_number</parameter> est un UID + </simpara> + </listitem> + <listitem> + <simpara> + <constant>FT_PEEK</constant> - Ne pas lever le drapeau \Seen (Message lu) s'il n'est pas déjà levé. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>FT_INTERNAL</constant> - La chaîne renvoyée est au + format interne, et ne va pas canoniser les CRLF. + </simpara> + </listitem> + </itemizedlist> + </para> </listitem> - </itemizedlist> - </para> - <para> - <function>imap_body</function> va retourner une copie brute du corps du - message. Pour extraire les sous-parties MIME du message, utilisez - <function>imap_fetchstructure</function> pour analyser la structure, - et <function>imap_fetchbody</function> pour extraire une copie d'une - des sous-partie. - </para> - </refsect1> - </refentry> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le corps du message spécifié, sous la forme d'une &string;. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -72,4 +98,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-check.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-check.xml diff -u phpdoc-fr/reference/imap/functions/imap-check.xml:1.12 phpdoc-fr/reference/imap/functions/imap-check.xml:1.13 --- phpdoc-fr/reference/imap/functions/imap-check.xml:1.12 Wed Sep 13 03:05:59 2006 +++ phpdoc-fr/reference/imap/functions/imap-check.xml Mon Jan 29 17:23:37 2007 @@ -1,67 +1,77 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-check"> - <refnamediv> - <refname>imap_check</refname> - <refpurpose> - Vérifie le courrier de la boîte aux lettres courante - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>object</type><methodname>imap_check</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_check</function> retourne les informations à - propos de la boîte aux lettres courante. - <function>imap_check</function> retourne &false; - en cas d'échec. - </para> - <para> - <function>imap_check</function> vérifie le statut de la boîte - aux lettres courante, sur le serveur <parameter>imap_stream</parameter>, et - retourne les informations dans un objet avec les membres suivants : - </para> - <para> - <itemizedlist> - <listitem> - <simpara> - Date - Date de dernière modification du contenu de la - boîte aux lettres en accord avec la <ulink url="&url.rfc;2822">RFC2822</ulink> - </simpara> - </listitem> - <listitem> - <simpara> - Driver - protocole utilisé pour accéder à la - boîte aux lettres: <acronym>POP3</acronym>, - <acronym>IMAP</acronym>, <acronym>NNTP</acronym>. - </simpara> - </listitem> - <listitem> - <simpara> - Mailbox - nom de la boîte aux lettres - </simpara> - </listitem> - <listitem> - <simpara> - Nmsgs - nombre de messages de la boîte aux lettres - </simpara> - </listitem> - <listitem> - <simpara> - Recent - nombre de messages récents de la boîte aux lettres - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - <example> - <title>Exemple avec <function>imap_check</function></title> - <programlisting role="php"> + +<refentry id="function.imap-check"> + <refnamediv> + <refname>imap_check</refname> + <refpurpose>Vérifie le courrier de la boîte aux lettres courante</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>object</type><methodname>imap_check</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + </methodsynopsis> + <para> + <function>imap_check</function> retourne les informations à + propos de la boîte aux lettres courante. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne les informations dans un objet contenant les propriétés suivantes : + <itemizedlist> + <listitem> + <simpara> + Date - Date de dernière modification du contenu de la + boîte aux lettres en accord avec la <ulink url="&url.rfc;2822">RFC2822</ulink> + </simpara> + </listitem> + <listitem> + <simpara> + Driver - protocole utilisé pour accéder à la + boîte aux lettres: <acronym>POP3</acronym>, + <acronym>IMAP</acronym>, <acronym>NNTP</acronym>. + </simpara> + </listitem> + <listitem> + <simpara> + Mailbox - nom de la boîte aux lettres + </simpara> + </listitem> + <listitem> + <simpara> + Nmsgs - nombre de messages de la boîte aux lettres + </simpara> + </listitem> + <listitem> + <simpara> + Recent - nombre de messages récents de la boîte aux lettres + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + Retourne &false; si une erreur survient. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_check</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -70,9 +80,9 @@ ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ object(stdClass)(5) { ["Date"]=> @@ -88,11 +98,11 @@ int(0) } ]]> - </screen> - </example> - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -113,4 +123,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml diff -u phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml:1.14 phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml:1.15 --- phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml:1.14 Wed Sep 13 03:05:59 2006 +++ phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml Mon Jan 29 17:23:37 2007 @@ -1,46 +1,88 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.7 Maintainer: didou Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-clearflag-full"> - <refnamediv> - <refname>imap_clearflag_full</refname> - <refpurpose>Supprime un flag (drapeau) sur un message</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imap_clearflag_full</methodname> - <methodparam><type>resource</type><parameter>stream</parameter></methodparam> - <methodparam><type>string</type><parameter>sequence</parameter></methodparam> - <methodparam><type>string</type><parameter>flag</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>options</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_clearflag_full</function> efface le flag - <parameter>flag</parameter> dans les messages de la séquence - <parameter>sequence</parameter>, du flux imap <parameter>stream</parameter>. - Les flags <parameter>flag</parameter> que vous pouvez effacer sont - "\\Seen", "\\Answered", "\\Flagged", "\\Deleted" et "\\Draft" (tels - que définis dans la <ulink url="&url.rfc;2060">RFC2060</ulink>). &return.success;. - </para> - <para> - <parameter>options</parameter> est un masque de bit, qui accepte - uniquement la valeur suivante : - <itemizedlist> + +<refentry id="function.imap-clearflag-full"> + <refnamediv> + <refname>imap_clearflag_full</refname> + <refpurpose>Supprime un flag (drapeau) sur un message</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imap_clearflag_full</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>sequence</parameter></methodparam> + <methodparam><type>string</type><parameter>flag</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <para> + <function>imap_clearflag_full</function> efface le flag + <parameter>flag</parameter> dans les messages de la séquence + <parameter>sequence</parameter>, du flux imap <parameter>stream</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>sequence</parameter></term> + <listitem> + <para> + Une séquence de numéro de messages. Vous pouvez énumérer les messages + désirées avec la synthaxe <literal>X,Y</literal>, ou récupérer tous les messages + contenus dans un intervalle, avec la synthaxe <literal>X:Y</literal> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>flag</parameter></term> + <listitem> + <para> + Les flags <parameter>flag</parameter> que vous pouvez effacer sont + "\\Seen", "\\Answered", "\\Flagged", "\\Deleted" et "\\Draft" (tels + que définis dans la <ulink url="&url.rfc;2060">RFC2060</ulink>) + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> <listitem> - <simpara> - <constant>ST_UID</constant> - la séquence contient des UID au lieu de - numéros de séquence. - </simpara> + <para> + <parameter>options</parameter> est un masque de bit, qui accepte + uniquement la valeur suivante : + <itemizedlist> + <listitem> + <simpara> + <constant>ST_UID</constant> - la séquence contient des UID au lieu de + numéros de séquence + </simpara> + </listitem> + </itemizedlist> + </para> </listitem> - </itemizedlist> - </para> - <para> - Voir aussi <function>imap_setflag_full</function>. - </para> - </refsect1> - </refentry> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_setflag_full</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -61,4 +103,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-close.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-close.xml diff -u phpdoc-fr/reference/imap/functions/imap-close.xml:1.10 phpdoc-fr/reference/imap/functions/imap-close.xml:1.11 --- phpdoc-fr/reference/imap/functions/imap-close.xml:1.10 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-close.xml Mon Jan 29 17:23:37 2007 @@ -1,30 +1,59 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.7 Maintainer: didou Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-close"> - <refnamediv> - <refname>imap_close</refname> - <refpurpose>Termine un flux IMAP</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imap_close</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>flag</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_close</function> termine un flux <acronym>IMAP</acronym>. - <function>imap_close</function> prend un argument optionnel - <parameter>flag</parameter>, <constant>CL_EXPUNGE</constant>, qui va - purger automatiquement la boîte aux lettres. - </para> - <para> - Voir aussi <function>imap_open</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-close"> + <refnamediv> + <refname>imap_close</refname> + <refpurpose>Termine un flux IMAP</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imap_close</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flag</parameter></methodparam> + </methodsynopsis> + <para> + Termine un flux IMAP. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>flag</parameter></term> + <listitem> + <para> + S'il est défini à <constant>CL_EXPUNGE</constant>, + la fonction effectuera une purge automatique de la boîte aux lettres + avant de la fermer, supprimant tous les messages marqués pour l'effacement. + Vous pouvez effectuer la même chose avec la fonction + <function>imap_expunge</function> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_open</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -45,4 +74,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-createmailbox.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-createmailbox.xml diff -u phpdoc-fr/reference/imap/functions/imap-createmailbox.xml:1.11 phpdoc-fr/reference/imap/functions/imap-createmailbox.xml:1.12 --- phpdoc-fr/reference/imap/functions/imap-createmailbox.xml:1.11 Tue Jan 24 18:05:43 2006 +++ phpdoc-fr/reference/imap/functions/imap-createmailbox.xml Mon Jan 29 17:23:37 2007 @@ -1,41 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.10 Maintainer: didou Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-createmailbox"> - <refnamediv> - <refname>imap_createmailbox</refname> - <refpurpose>Crée une nouvelle boîte aux lettres</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imap_createmailbox</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>mbox</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_createmailbox</function> crée une nouvelle boîte - aux lettres nommée <parameter>mbox</parameter>. Les noms - contenant des caractères spéciaux doivent être - encodés. - </para> - <para> - <function>imap_createmailbox</function> retourne &true; - en cas de succès, et &false; en cas d'erreur. - </para> - <para> - <example> - <title>Exemple avec <function>imap_createmailbox</function></title> - <programlisting role="php"> + +<refentry id="function.imap-createmailbox"> + <refnamediv> + <refname>imap_createmailbox</refname> + <refpurpose>Crée une nouvelle boîte aux lettres</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imap_createmailbox</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> + </methodsynopsis> + <para> + Crée une nouvelle boîte aux lettres nommée <parameter>mbox</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>mailbox</parameter></term> + <listitem> + <para> + Le nom de la boîte aux lettres, voir la documentation sur la fonction + <function>imap_open</function> pour plus d'informations. + Les noms contenant des caractères internationaux doivent être encodés + par la fonction <function>imap_utf7_encode</function> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_createmailbox</function></title> + <programlisting role="php"> <![CDATA[ <?php +$mbox = imap_open("{imap.example.org}", "username", "password", OP_HALFOPEN) + or die("connexion impossible : " . imap_last_error()); -$mbox = imap_open("{imap.example.org}", "utilisateur", "mot_de_passe", OP_HALFOPEN) - or die("connexion impossible: " . imap_last_error()); - -$name1 = "nouvellephpbox"; -$name2 = imap_utf7_encode("nouvellephpboxéx"); +$name1 = "phpnewbox"; +$name2 = imap_utf7_encode("phpnewb&ouml;x"); $newname = $name1; @@ -44,15 +65,16 @@ // Nous allons créer maintenant une nouvelle boîte aux lettres "phptestbox" // dans votre dossier inbox, vérifier son état et, finalement, la supprimer // pour remettre votre inbox dans son état initial. + if (@imap_createmailbox($mbox, imap_utf7_encode("{imap.example.org}INBOX.$newname"))) { $status = @imap_status($mbox, "{imap.example.org}INBOX.$newname", SA_ALL); if ($status) { echo "Votre nouvelle boîte '$name1' est dans l'état suivant :<br />\n"; - echo "Messages : " . $status->messages . "<br />\n"; - echo "Récent : " . $status->recent . "<br />\n"; - echo "Non lus : " . $status->unseen . "<br />\n"; - echo "UID suivant : " . $status->uidnext . "<br />\n"; - echo "UID validité : " . $status->uidvalidity . "<br />\n"; + echo "Messages : " . $status->messages . "<br />\n"; + echo "Récent : " . $status->recent . "<br />\n"; + echo "Non lus : " . $status->unseen . "<br />\n"; + echo "UIDnext : " . $status->uidnext . "<br />\n"; + echo "UIDvalidity :" . $status->uidvalidity . "<br />\n"; if (imap_renamemailbox($mbox, "{imap.example.org}INBOX.$newname", "{imap.example.org}INBOX.$name2")) { echo "renommage de la boîte aux lettres '$name1' en '$name2'<br />\n"; @@ -64,30 +86,33 @@ echo "imap_status sur la nouvelle boîte aux lettres a échoué : " . imap_last_error() . "<br />\n"; } - if(@imap_deletemailbox($mbox, "{imap.example.org}INBOX.$newname")) { - echo "new mailbox supprimée pour remettre tout en état<br />\n"; + if (@imap_deletemailbox($mbox, "{imap.example.org}INBOX.$newname")) { + echo "nouvelle boite aux lettres supprimée pour remettre tout en état<br />\n"; } else { echo "imap_deletemailbox sur la nouvelle boîte aux lettres a échoué : " . implode("<br />\n", imap_errors()) . "<br />\n"; } } else { - echo "Impossible de créer une nouvelle boîte aux lettres : " . implode("<br />\n", imap_errors()) . "<br />\n"; + echo "Impossible de créer une nouvelle boîte aux lettres : " . implode("<br />\n", imap_errors()) . "<br />\n"; } + imap_close($mbox); ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>imap_renamemailbox</function>, - <function>imap_deletemailbox</function> et - <function>imap_open</function> pour connaître le format des noms de - <parameter>mbox</parameter>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_renamemailbox</function></member> + <member><function>imap_deletemailbox</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -108,4 +133,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml diff -u phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml:1.8 phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml:1.9 --- phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml:1.8 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml Mon Jan 29 17:23:37 2007 @@ -1,36 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-deletemailbox"> - <refnamediv> - <refname>imap_deletemailbox</refname> - <refpurpose>Efface une boîte aux lettres</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imap_deletemailbox</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>mbox</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_deletemailbox</function> efface la boîte aux lettres - spécifiée. (voir <function>imap_open</function> pour connaître le format - des noms de <parameter>mbox</parameter>). - </para> - <para> - &return.success;. - </para> - <para> - Voir aussi - <function>imap_createmailbox</function>, - <function>imap_renamemailbox</function> et - <function>imap_open</function> pour le format du paramètre - <parameter>mbox</parameter>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-deletemailbox"> + <refnamediv> + <refname>imap_deletemailbox</refname> + <refpurpose>Efface une boîte aux lettres</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imap_deletemailbox</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> + </methodsynopsis> + <para> + Efface la boîte aux lettres spécifiée. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>mailbox</parameter></term> + <listitem> + <para> + Le nom de la boîte aux lettres, voir la documentation sur la + fonction <function>imap_open</function> pour plus de détails + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_createmailbox</function></member> + <member><function>imap_renamemailbox</function></member> + <member> + <function>imap_open</function> pour le format + <parameter>mbox</parameter> + </member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -51,4 +76,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-delete.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-delete.xml diff -u phpdoc-fr/reference/imap/functions/imap-delete.xml:1.11 phpdoc-fr/reference/imap/functions/imap-delete.xml:1.12 --- phpdoc-fr/reference/imap/functions/imap-delete.xml:1.11 Tue Jan 24 18:05:43 2006 +++ phpdoc-fr/reference/imap/functions/imap-delete.xml Mon Jan 29 17:23:37 2007 @@ -1,80 +1,114 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.9 Maintainer: didou Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-delete"> - <refnamediv> - <refname>imap_delete</refname> - <refpurpose> - Marque le fichier pour l'effacement, dans la boîte aux lettres courante - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imap_delete</methodname> - <methodparam><type>int</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>int</type><parameter>msg_number</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_delete</function> retourne &true;. - </para> - <para> - <function>imap_delete</function> marque le fichier - <parameter>msg_number</parameter> pour l'effacement, dans la - boîte aux lettres courante. Le paramètre optionnel - <parameter>flags</parameter> ne prend qu'une seule valeur, - <parameter>ft_uid</parameter>, qui indique à &php; qu'il faut traiter - <parameter>msg_number</parameter> comme un <parameter>uid</parameter>. - L'effacement réel n'interviendra que lors de l'appel de la fonction - <function>imap_expunge</function> ou de <function>imap_close</function> - avec le paramètre optionnel CL_EXPUNGE. - </para> - <note> - <para> - Les boîtes aux lettres POP3 n'ont pas les flags de leurs messages de sauvegardés - entre les connexions, donc, la fonction <function>imap_expunge</function> doit - être appelée pendant la même connexion pour que les messages marquées - pour effacement soient réellement purgés. - </para> - </note> - <para> - <example> - <title>Exemple avec <function>imap_delete</function></title> - <programlisting role="php"> + +<refentry id="function.imap-delete"> + <refnamediv> + <refname>imap_delete</refname> + <refpurpose>Marque le fichier pour l'effacement, dans la boîte aux lettres courante</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imap_delete</methodname> + <methodparam><type>int</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>int</type><parameter>msg_number</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <para> + Marque les messages <parameter>msg_number</parameter> pour l'effacement. + L'effacement réel n'interviendra que lors de l'appel de la fonction + <function>imap_expunge</function> ou de <function>imap_close</function> + avec le paramètre optionnel <constant>CL_EXPUNGE</constant>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>msg_number</parameter></term> + <listitem> + <para> + Le numéro du message + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> + <listitem> + <para> + Vous pouvez le définir à <constant>FT_UID</constant> + qui demande à la fonction de traiter l'argument + <parameter>msg_number</parameter> comme un <literal>UID</literal>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true;. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_delete</function></title> + <programlisting role="php"> <![CDATA[ <?php -$mbox = imap_open("{imap.example.org}INBOX", "utilisateur", "mot_de_passe") - or die ("connexion impossible: " . imap_last_error()); +$mbox = imap_open("{imap.example.org}INBOX", "username", "password") + or die("Connexion impossible : " . imap_last_error()); $check = imap_mailboxmsginfo($mbox); -echo "Nombre de messages avant effacement : " . $check->Nmsgs . "<br />\n" ; +echo "Nombre de messages avant effacement : " . $check->Nmsgs . "<br />\n"; imap_delete($mbox, 1); -$check = imap_mailboxmsginfo ($mbox); -echo "Nombre de messages après effacement: " . $check->Nmsgs . "<br />\n" ; +$check = imap_mailboxmsginfo($mbox); +echo "Nombre de messages après effacement : " . $check->Nmsgs . "<br />\n"; -imap_expunge ($mbox); +imap_expunge($mbox); -$check = imap_mailboxmsginfo ($mbox); -echo "Nombre de messages après imap_expunge: " . $check->Nmsgs . "<br />\n" ; +$check = imap_mailboxmsginfo($mbox); +echo "Nombre de messages après imap_expunge : " . $check->Nmsgs . "<br />\n"; -imap_close ($mbox); +imap_close($mbox); ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> <para> - Voir aussi <function>imap_undelete</function>, - <function>imap_expunge</function> et - <function>imap_close</function>. + Les boîtes aux lettres POP3 n'ont pas les flags de leurs messages de sauvegardés + entre les connexions, donc, la fonction <function>imap_expunge</function> doit + être appelée pendant la même connexion pour que les messages marquées + pour effacement soient réellement purgés. </para> - </refsect1> - </refentry> + </note> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_undelete</function></member> + <member><function>imap_expunge</function></member> + <member><function>imap_close</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -95,4 +129,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-errors.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-errors.xml diff -u phpdoc-fr/reference/imap/functions/imap-errors.xml:1.10 phpdoc-fr/reference/imap/functions/imap-errors.xml:1.11 --- phpdoc-fr/reference/imap/functions/imap-errors.xml:1.10 Tue May 2 23:07:36 2006 +++ phpdoc-fr/reference/imap/functions/imap-errors.xml Mon Jan 29 17:23:37 2007 @@ -1,32 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.6 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.8 Maintainer: jsgoupil Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-errors"> - <refnamediv> - <refname>imap_errors</refname> - <refpurpose>Retourne toutes les erreurs</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>imap_errors</methodname> - <void/> - </methodsynopsis> - <para> - Cette fonction retourne un tableau de tous les messages d'erreurs - <acronym>IMAP</acronym> générés depuis le dernier appel à - <function>imap_errors</function> ou depuis le début de la page. Retourne - &false; si aucun message d'erreur n'est disponible. - Lorsque <function>imap_errors</function> est appelée, la pile d'erreurs - est vidée. - </para> - <para> - Voyez aussi <function>imap_last_error</function>&listendand; - <function>imap_alerts</function> - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-errors"> + <refnamediv> + <refname>imap_errors</refname> + <refpurpose>etourne toutes les erreurs</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>imap_errors</methodname> + <void/> + </methodsynopsis> + <para> + Cette fonction retourne un tableau de tous les messages d'erreurs + <acronym>IMAP</acronym> générés depuis le dernier appel à + <function>imap_errors</function> ou depuis le début de la page. + </para> + <para> + Lorsque <function>imap_errors</function> est appelée, la pile d'erreurs + est vidée. + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Cette fonction retourne un tableau contenant tous les messages d'erreur + IMAP générés depuis le dernier appel à la fonction + <function>imap_errors</function> ou depuis le début de la page. + Retourne &false; si aucun message d'erreur n'est disponible. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_last_error</function></member> + <member><function>imap_alerts</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -47,4 +63,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-expunge.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-expunge.xml diff -u phpdoc-fr/reference/imap/functions/imap-expunge.xml:1.9 phpdoc-fr/reference/imap/functions/imap-expunge.xml:1.10 --- phpdoc-fr/reference/imap/functions/imap-expunge.xml:1.9 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-expunge.xml Mon Jan 29 17:23:37 2007 @@ -1,29 +1,40 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-expunge"> - <refnamediv> - <refname>imap_expunge</refname> - <refpurpose>Efface tous les messages marqués pour l'effacement</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imap_expunge</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_expunge</function> efface tous les messages marqués pour - l'effacement par <function>imap_delete</function>, - <function>imap_mail_move</function>, ou - <function>imap_setflag_full</function>. - </para> - <para> - <function>imap_expunge</function> retourne &true;. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-expunge"> + <refnamediv> + <refname>imap_expunge</refname> + <refpurpose>Efface tous les messages marqués pour l'effacement</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imap_expunge</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + </methodsynopsis> + <para> + Efface tous les messages marqués pour l'effacement par + <function>imap_delete</function>, <function>imap_mail_move</function>, + ou <function>imap_setflag_full</function>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true;. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -44,4 +55,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-fetchbody.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-fetchbody.xml diff -u phpdoc-fr/reference/imap/functions/imap-fetchbody.xml:1.11 phpdoc-fr/reference/imap/functions/imap-fetchbody.xml:1.12 --- phpdoc-fr/reference/imap/functions/imap-fetchbody.xml:1.11 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-fetchbody.xml Mon Jan 29 17:23:37 2007 @@ -1,60 +1,98 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-fetchbody"> - <refnamediv> - <refname>imap_fetchbody</refname> - <refpurpose>Retourne une section extraite du corps d'un message</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>imap_fetchbody</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>int</type><parameter>msg_number</parameter></methodparam> - <methodparam><type>string</type><parameter>part_number</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_fetchbody</function> va rechercher une section du corps - du message, et la retourne sous la forme d'une chaîne. La section - est une chaîne d'entiers, séparés par des virgules, qui - servent d'index dans le corps du message, comme spécifié dans - la norme IMAP4. Le texte n'est alors pas décodé par - <function>imap_fetchbody</function>. - </para> - <para> - L'option <function>imap_fetchbody</function> est un masque qui peut - contenir les valeurs suivantes : - <itemizedlist> + +<refentry id="function.imap-fetchbody"> + <refnamediv> + <refname>imap_fetchbody</refname> + <refpurpose>Retourne une section extraite du corps d'un message</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>imap_fetchbody</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>int</type><parameter>msg_number</parameter></methodparam> + <methodparam><type>string</type><parameter>part_number</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <para> + Récupère une section particulière du corps des messages spécifiés. + Les parties du corps ne sont pas décodées par cette fonction. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>msg_number</parameter></term> <listitem> - <simpara> - <constant>FT_UID</constant> - <parameter>msg_number</parameter> est - un UID - </simpara> + <para> + Le numéro du message + </para> </listitem> + </varlistentry> + <varlistentry> + <term><parameter>part_number</parameter></term> <listitem> - <simpara> - <constant>FT_PEEK</constant> - Ne pas lever le drapeau \Seen - (Message lu) s'il n'est pas - déjà levé. - </simpara> + <para> + Le numéro de la section. C'est une chaîne d'entiers, délimités + par une virgule qui correspondent aux index dans la liste + des sections du message, tel que prévu par la spécification IMPA4. + </para> </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> <listitem> - <simpara> - <constant>FT_INTERNAL</constant> - La chaîne renvoyée est au format - interne, et ne va pas canoniser les CRLF. - </simpara> + <para> + L'option <function>imap_fetchbody</function> est un masque qui peut + contenir les valeurs suivantes : + <itemizedlist> + <listitem> + <simpara> + <constant>FT_UID</constant> - <parameter>msg_number</parameter> est un UID + </simpara> + </listitem> + <listitem> + <simpara> + <constant>FT_PEEK</constant> - Ne pas lever le drapeau \Seen + (Message lu) s'il n'est pas déjà levé. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>FT_INTERNAL</constant> - La chaîne renvoyée est au format + interne, et ne va pas canoniser les CRLF. + </simpara> + </listitem> + </itemizedlist> + </para> </listitem> - </itemizedlist> - </para> - <para> - Voir aussi - <function>imap_fetchstructure</function>. - </para> - </refsect1> - </refentry> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne une section particulière du corps des messages spécifiés, sous + la forme d'une &string;. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_savebody</function></member> + <member><function>imap_fetchstructure</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -75,4 +113,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-fetchheader.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-fetchheader.xml diff -u phpdoc-fr/reference/imap/functions/imap-fetchheader.xml:1.9 phpdoc-fr/reference/imap/functions/imap-fetchheader.xml:1.10 --- phpdoc-fr/reference/imap/functions/imap-fetchheader.xml:1.9 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-fetchheader.xml Mon Jan 29 17:23:37 2007 @@ -1,54 +1,88 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.6 Maintainer: didou Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-fetchheader"> - <refnamediv> - <refname>imap_fetchheader</refname> - <refpurpose>Retourne l'en-tête d'un message</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>imap_fetchheader</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>int</type><parameter>msgno</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_fetchheader</function> retourne l'en-tête brut et - complet <ulink url="&url.rfc;2822">RFC2822</ulink> - du message <parameter>msgno</parameter>, - sous la forme d'une chaîne. - </para> - <para> - Les <parameter>options</parameter> sont : - <itemizedlist> - <listitem> - <simpara> - <constant>FT_UID</constant> - L'argument - <parameter>msgno</parameter> est un UID - </simpara> - </listitem> + +<refentry id="function.imap-fetchheader"> + <refnamediv> + <refname>imap_fetchheader</refname> + <refpurpose>Retourne l'en-tête d'un message</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>imap_fetchheader</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>int</type><parameter>msg_number</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <para> + <function>imap_fetchheader</function> retourne l'en-tête brut et + complet <ulink url="&url.rfc;2822">RFC2822</ulink> du message + <parameter>msgno</parameter>, sous la forme d'une chaîne. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>msg_number</parameter></term> <listitem> - <simpara> - <constant>FT_INTERNAL</constant> - la chaîne renvoyée est - au format "internal" , c'est-à-dire sans canonisation des CRLF - </simpara> + <para> + Le numéro du message + </para> </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> <listitem> - <simpara> - <constant>FT_PREFETCHTEXT</constant> - RFC822.TEXT doit être pré - téléchargé en même temps que l'en-tête. - Cela réduit le RTT sur une connexion <acronym>IMAP</acronym>, si - le message complet est souhaité. (e.g. dans une opération - de sauvegarde dans un fichier). - </simpara> + <para> + Les options possibles sont : + <itemizedlist> + <listitem> + <simpara> + <constant>FT_UID</constant> - <parameter>msgno</parameter> est un UID + </simpara> + </listitem> + <listitem> + <simpara> + <constant>FT_INTERNAL</constant> - La chaîne renvoyée est + au format "internal" , c'est-à-dire sans canonisation des CRLF + </simpara> + </listitem> + <listitem> + <simpara> + <constant>FT_PREFETCHTEXT</constant> - RFC822.TEXT doit être pré + téléchargé en même temps que l'en-tête. + Cela réduit le RTT sur une connexion <acronym>IMAP</acronym>, si + le message complet est souhaité. (e.g. dans une opération + de sauvegarde dans un fichier). + </simpara> + </listitem> + </itemizedlist> + </para> </listitem> - </itemizedlist> - </para> - </refsect1> - </refentry> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne l'en-tête du message spécifié, sous la forme d'une &string;. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_fetch_overview</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -69,4 +103,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml diff -u phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml:1.13 phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml:1.14 --- phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml:1.13 Tue Jan 24 18:05:43 2006 +++ phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml Mon Jan 29 17:23:37 2007 @@ -1,137 +1,180 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.10 Maintainer: didou Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-fetch-overview"> - <refnamediv> - <refname>imap_fetch_overview</refname> - <refpurpose> - Lit un sommaire des en-têtes de messages - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>imap_fetch_overview</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>sequence</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_fetch_overview</function> lit les en-têtes des courriers - électroniques de la séquence <parameter>sequence</parameter> et retourne - un sommaire de leur contenu. <parameter>sequence</parameter> va contenir - une séquence d'indice de message ou d'UIDs, si <parameter>flags</parameter> - cotient FT_UID. La valeur retournée est un tableau d'objets : un par - message d'en-tête décrit : - <itemizedlist> - <listitem> - <simpara> - subject - Le sujet du message - </simpara> - </listitem> - <listitem> - <simpara> - from - Expéditeur - </simpara> - </listitem> - <listitem> - <simpara> - to - Destinataire - </simpara> - </listitem> - <listitem> - <simpara> - date - Date d'expédition - </simpara> - </listitem> - <listitem> - <simpara> - message_id - Identification du message - </simpara> - </listitem> - <listitem> - <simpara> - references - est une référence sur l'id de ce message - </simpara> - </listitem> - <listitem> - <simpara> - in_reply_to - est une réponse à cet identifiant de message - </simpara> - </listitem> - <listitem> - <simpara> - size - taille en octets - </simpara> - </listitem> - <listitem> - <simpara> - uid - UID du message dans la boîte aux lettres - </simpara> - </listitem> - <listitem> - <simpara> - msgno - numéro de séquence du message dans la boîte - </simpara> - </listitem> - <listitem> - <simpara> - recent - Ce message est récent - </simpara> - </listitem> - <listitem> - <simpara> - flagged - Ce message est marqué - </simpara> - </listitem> - <listitem> - <simpara> - answered - Ce message a donné lieu à une réponse - </simpara> - </listitem> - <listitem> - <simpara> - deleted - Ce message est marqué pour l'effacement - </simpara> - </listitem> - <listitem> - <simpara> - seen - Ce message est déjà lu - </simpara> - </listitem> - <listitem> - <simpara> - draft - Ce message est un brouillon - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - <example> - <title>Exemple avec <function>imap_fetch_overview</function></title> - <programlisting role="php"> + +<refentry id="function.imap-fetch-overview"> + <refnamediv> + <refname>imap_fetch_overview</refname> + <refpurpose>Lit le sommaire des en-têtes de messages</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>imap_fetch_overview</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>sequence</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <para> + <function>imap_fetch_overview</function> lit les en-têtes des courriers + électroniques de la séquence <parameter>sequence</parameter> et retourne + un sommaire de leur contenu. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>sequence</parameter></term> + <listitem> + <para> + Une description de la séquence du message. Vous pouvez énumérer les + messages désirés avec la synthaxe <literal>X,Y</literal>, ou récupérer + tous les messages d'un intervalle, avec la synthaxe <literal>X:Y</literal> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> + <listitem> + <para> + <parameter>sequence</parameter> va contenir une séquence + d'indice de message ou d'UIDs, si <parameter>flags</parameter> + contient FT_UID. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau d'objets décrivant l'en-tête de chaque message. + L'objet ne définira une propriété que si elle existe. Les propriétés + possibles sont : + <itemizedlist> + <listitem> + <simpara> + subject - Le sujet du message + </simpara> + </listitem> + <listitem> + <simpara> + from - Expéditeur + </simpara> + </listitem> + <listitem> + <simpara> + to - Destinataire + </simpara> + </listitem> + <listitem> + <simpara> + date - Date d'expédition + </simpara> + </listitem> + <listitem> + <simpara> + message_id - Identification du message + </simpara> + </listitem> + <listitem> + <simpara> + references - est une référence sur l'id de ce message + </simpara> + </listitem> + <listitem> + <simpara> + in_reply_to - est une réponse à cet identifiant de message + </simpara> + </listitem> + <listitem> + <simpara> + size - taille en octets + </simpara> + </listitem> + <listitem> + <simpara> + uid - UID du message dans la boîte aux lettres + </simpara> + </listitem> + <listitem> + <simpara> + msgno - numéro de séquence du message dans la boîte + </simpara> + </listitem> + <listitem> + <simpara> + recent - Ce message est récent + </simpara> + </listitem> + <listitem> + <simpara> + flagged - Ce message est marqué + </simpara> + </listitem> + <listitem> + <simpara> + answered - Ce message a donné lieu à une réponse + </simpara> + </listitem> + <listitem> + <simpara> + deleted - Ce message est marqué pour l'effacement + </simpara> + </listitem> + <listitem> + <simpara> + seen - Ce message est déjà lu + </simpara> + </listitem> + <listitem> + <simpara> + draft - Ce message est un brouillon + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_fetch_overview</function></title> + <programlisting role="php"> <![CDATA[ <?php -$mbox = imap_open("{imap.example.org:143}", "username", "password") - or die("can't connect: " . imap_last_error()); +$mbox = imap_open("{imap.example.org:143}INBOX", "username", "password") + or die("Connexion impossible : " . imap_last_error()); -$overview = imap_fetch_overview($mbox, "2,4:6", 0); +$MC = imap_check($mbox); -if (is_array($overview)) { - foreach ($overview as $val) { - echo "$val->msgno - $val->date - $val->subject\n"; - } +// Récupère le sommaire pour tous les messages contenus dans INBOX +$result = imap_fetch_overview($mbox,"1:{$MC->Nmsgs}",0); +foreach ($result => $overview) { + echo "#{$overview->msgno} ({$overview->date}) - From: {$overview->from} + {$overview->subject}\n"; } - imap_close($mbox); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_fetchheader</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml diff -u phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml:1.15 phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml:1.16 --- phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml:1.15 Sun Oct 15 15:52:02 2006 +++ phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml Mon Jan 29 17:23:37 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.7 Maintainer: didou Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.imap-fetchstructure"> <refnamediv> <refname>imap_fetchstructure</refname> - <refpurpose> - Lit la structure d'un message - </refpurpose> + <refpurpose>Lit la structure d'un message</refpurpose> </refnamediv> - <refsect1> + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>object</type><methodname>imap_fetchstructure</methodname> @@ -20,14 +18,42 @@ </methodsynopsis> <para> <function>imap_fetchstructure</function> lit la structure du message - <parameter>msg_number</parameter>. <function>imap_fetchstructure</function> - dispose d'un paramètre <parameter>options</parameter>, qui n'a qu'une seule valeur, - <parameter>ft_uid</parameter>, pour indiquer que l'argument - <parameter>msg_number</parameter> est un <parameter>uid</parameter>. - <function>imap_fetchstructure</function> retourne un objet avec des - propriétés d'enveloppe, de date interne, de taille, de - structure de flags et de corps, ainsi qu'un objet pour chaque attachement. - La structure est la suivante : + <parameter>msg_number</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>msg_number</parameter></term> + <listitem> + <para> + Le numéro du message + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> + <listitem> + <para> + Ce paramètre optionnel n'a qu'une seule option, + <constant>FT_UID</constant>, qui demande à la fonction de traiter + l'argument <parameter>msg_number</parameter> comme un + <literal>UID</literal>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un objet avec des propriétés d'enveloppe, de date interne, + de taille, de structure de flags et de corps, ainsi qu'un objet pour + chaque attachement. La structure est la suivante : </para> <para> <table> @@ -50,7 +76,7 @@ </row> <row> <entry>subtype</entry> - <entry>sous type<acronym>MIME</acronym></entry> + <entry>sous type <acronym>MIME</acronym></entry> </row> <row> <entry>ifdescription</entry> @@ -86,17 +112,13 @@ </row> <row> <entry>ifdparameters</entry> - <entry> - &true; s'il y a un tableau de paramètres dparameters - </entry> + <entry>&true; s'il y a un tableau de paramètres dparameters</entry> </row> <row> <entry>dparameters</entry> - <entry> - tableau d'objets où chaque objet a une propriété "attribute" et une + <entry>tableau d'objets où chaque objet a une propriété "attribute" et une propriété "value" correspondant aux paramètres d'en-têtes - Content-disposition <acronym>MIME</acronym>. - </entry> + Content-disposition <acronym>MIME</acronym>.</entry> </row> <row> <entry>ifparameters</entry> @@ -109,7 +131,7 @@ </row> <row> <entry>parts</entry> - <entry>Tableau d'objets décrivant chaque partie + <entry>Tableau d'objets décrivant chaque partie <acronym>MIME</acronym> du message</entry> </row> </tbody> @@ -118,26 +140,26 @@ </para> <para> <table> - <title>Type primaire de corps</title> - <tgroup cols="2"> - <tbody> + <title>Type primaire de corps</title> + <tgroup cols="2"> + <tbody> <row><entry>0</entry><entry>text</entry></row> <row><entry>1</entry><entry>multipart</entry></row> <row><entry>2</entry><entry>message</entry></row> <row><entry>3</entry><entry>application</entry></row> <row><entry>4</entry><entry>audio</entry></row> <row><entry>5</entry><entry>image</entry></row> - <row><entry>6</entry><entry>vidéo</entry></row> - <row><entry>7</entry><entry>autre</entry></row> - </tbody> - </tgroup> + <row><entry>6</entry><entry>video</entry></row> + <row><entry>7</entry><entry>other</entry></row> + </tbody> + </tgroup> </table> </para> <para> <table> - <title>Codage de transfert</title> - <tgroup cols="2"> - <tbody> + <title>Codage de transfert</title> + <tgroup cols="2"> + <tbody> <row><entry>0</entry><entry>7BIT</entry></row> <row><entry>1</entry><entry>8BIT</entry></row> <row><entry>2</entry><entry>BINARY</entry></row> @@ -148,9 +170,13 @@ </tgroup> </table> </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Voir aussi - <function>imap_fetchbody</function>. + <simplelist> + <member><function>imap_fetchbody</function></member> + </simplelist> </para> </refsect1> </refentry> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-getacl.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-getacl.xml diff -u phpdoc-fr/reference/imap/functions/imap-getacl.xml:1.10 phpdoc-fr/reference/imap/functions/imap-getacl.xml:1.11 --- phpdoc-fr/reference/imap/functions/imap-getacl.xml:1.10 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-getacl.xml Mon Jan 29 17:23:37 2007 @@ -1,33 +1,55 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-getacl"> - <refnamediv> - <refname>imap_getacl</refname> - <refpurpose> - Retourne le ACL pour la boîte aux lettres - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>imap_getacl</methodname> - <methodparam><type>resource</type><parameter>stream_id</parameter></methodparam> - <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> - </methodsynopsis> - &warn.undocumented.func; - <para> - <function>imap_getacl</function> n'est actuellement disponible que pour les - utilisateurs de la bibliothèque <literal>c-client2000</literal> ou supérieur. - </para> - <para> - Voir aussi - <function>imap_setacl</function>. - </para> - </refsect1> - </refentry> +<refentry id="function.imap-getacl"> + <refnamediv> + <refname>imap_getacl</refname> + <refpurpose>Retourne le ACL pour la boîte aux lettres</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>imap_getacl</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> + </methodsynopsis> + &warn.undocumented.func; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>mailbox</parameter></term> + <listitem> + <para> + Le nom de la boîte aux lettres, voir la documentation de la fonction + <function>imap_open</function> pour plus de détails. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <para> + Cette fonction n'est actuellement disponible que pour les + utilisateurs de la bibliothèque <literal>c-client2000</literal> ou supérieur. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_setacl</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -48,4 +70,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml diff -u phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml:1.12 phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml:1.13 --- phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml:1.12 Tue Jan 24 18:05:43 2006 +++ phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml Mon Jan 29 17:23:37 2007 @@ -1,96 +1,116 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.8 Maintainer: didou Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-getmailboxes"> - <refnamediv> - <refname>imap_getmailboxes</refname> - <refpurpose> - Liste les boîtes aux lettres, et retourne les détails de chacune - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>imap_getmailboxes</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>ref</parameter></methodparam> - <methodparam><type>string</type><parameter>pattern</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_getmailboxes</function> retourne un tableau d'objets contenant - les informations sur les boîtes aux lettres. Chaque objet possède un attribut - de <parameter>name</parameter>, qui contient le nom complet de la boîte - aux lettres, <parameter>delimiter</parameter> qui est le délimiteur - hiérarchique et <parameter>attributes</parameter>. - <parameter>attributes</parameter> est un masque de bits, qui contient : - <itemizedlist> - <listitem> - <simpara> - <constant>LATT_NOINFERIORS</constant> - Cette boîte aux lettres - n'a pas d'"enfants" (il n'y a plus de boîtes aux lettres en - dessous de celle-ci). - </simpara> - </listitem> - <listitem> - <simpara> - <constant>LATT_NOSELECT</constant> - Ceci est juste un container, - pas une boîte aux lettres (vous ne pouvez pas l'ouvrir). - </simpara> - </listitem> + +<refentry id="function.imap-getmailboxes"> + <refnamediv> + <refname>imap_getmailboxes</refname> + <refpurpose>Liste les boîtes aux lettres, et retourne les détails de chacune</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>imap_getmailboxes</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>ref</parameter></methodparam> + <methodparam><type>string</type><parameter>pattern</parameter></methodparam> + </methodsynopsis> + <para> + Liste les boîtes aux lettres. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>ref</parameter></term> <listitem> - <simpara> - <constant>LATT_MARKED</constant> - Cette boîte aux lettres est marquée. - Utilisé uniquement avec UW-IMAPD. - </simpara> + <para> + <parameter>ref</parameter> ne devrait être que le serveur + sous la forme décrite dans <function>imap_open</function> + </para> </listitem> + </varlistentry> + <varlistentry> + <term><parameter>pattern</parameter></term> <listitem> - <simpara> - <constant>LATT_UNMARKED</constant> - Cette boîte aux lettres n'est pas - marquée. Utilisé uniquement avec UW-IMAPD. - </simpara> + <para> + Spécifie la position dans la hiérarchie des boîtes aux lettres, où il faut + commencer à chercher. + </para> + <para> + Il y a deux caractères spéciaux que vous pouvez utiliser dans + <parameter>pattern</parameter> : '*' et '%'. '*' signifie : toutes les + boîtes aux lettres. Si vous passez <parameter>pattern</parameter> + comme '*', vous obtiendrez la liste complète des boîtes aux + lettres de la hiérarchie. '%' signifie qu'on ne s'interesse qu'au + niveau courant. '%' passé à <parameter>pattern</parameter> + ne retournera que les boîtes aux lettres de niveau supérieur; + '~/mail/%'.Sous UW_IMAPD retournera toutes les boîtes aux lettres du + dossier <filename>~/mail directory</filename>, mais pas leurs enfants. + </para> </listitem> - </itemizedlist> - </para> - <para> - Les noms de boîtes aux lettres contenant des caractères internationaux - hors de l'espace ASCII seront encodés et pourront être décodés avec - <function>imap_utf7_decode</function>. - </para> - <para> - <parameter>ref</parameter> ne devrait être que le serveur - sous la forme décrite dans <function>imap_open</function>, et - <parameter>pattern</parameter> spécifie la position dans la - hiérarchie des boîtes aux lettres, où il faut - commencer à chercher. Si vous voulez passer en revue toute la - hiérarchie, passez '*' comme <parameter>pattern</parameter>. - </para> - <para> - Il y a deux caractères spéciaux que vous pouvez utiliser dans - <parameter>pattern</parameter> : '*' et '%'. '*' signifie : toutes les - boîtes aux lettres. Si vous passez <parameter>pattern</parameter> - comme '*', vous obtiendrez la liste complète des boîtes aux - lettres de la hiérarchie. '%' signifie qu'on ne s'interesse qu'au - niveau courant. '%' passé à <parameter>pattern</parameter> - ne retournera que les boîtes aux lettres de niveau supérieur; - '~/mail/%'.Sous UW_IMAPD retournera toutes les boîtes aux lettres du - dossier <filename>~/mail directory</filename>, mais pas leurs enfants. - </para> - <para> - <example> - <title>Exemple avec <function>imap_getmailboxes</function></title> - <programlisting role="php"> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau d'objets contenant les informations sur les + boîtes aux lettres. Chaque objet possède un attribut de + <parameter>name</parameter>, qui contient le nom complet + de la boîte aux lettres, <parameter>delimiter</parameter> qui + est le délimiteur hiérarchique et <parameter>attributes</parameter>. + <parameter>attributes</parameter> est un masque de bits, qui contient : + <itemizedlist> + <listitem> + <simpara> + <constant>LATT_NOINFERIORS</constant> - Cette boîte aux lettres + n'a pas d'"enfants" (il n'y a plus de boîtes aux lettres en + dessous de celle-ci). + </simpara> + </listitem> + <listitem> + <simpara> + <constant>LATT_NOSELECT</constant> - Ceci est juste un container, + pas une boîte aux lettres (vous ne pouvez pas l'ouvrir). + </simpara> + </listitem> + <listitem> + <simpara> + <constant>LATT_MARKED</constant> - Cette boîte aux lettres est marquée. + Utilisé uniquement avec UW-IMAPD. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>LATT_UNMARKED</constant> - Cette boîte aux lettres n'est pas + marquée. Utilisé uniquement avec UW-IMAPD. + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_getmailboxes</function></title> + <programlisting role="php"> <![CDATA[ <?php -$mbox = imap_open("{imap.example.org}", "utilisateur", "mot_de_passe", OP_HALFOPEN) - or die("connexion impossible : " . imap_last_error()); +$mbox = imap_open("{imap.example.org}", "username", "password", OP_HALFOPEN) + or die("Connexion impossible : " . imap_last_error()); $list = imap_getmailboxes($mbox, "{imap.example.org}", "*"); -if(is_array($list)) { - reset($list); +if (is_array($list)) { foreach ($list as $key => $val) { echo "($key) "; - echo imap_utf7_decode($val->name).","; + echo imap_utf7_decode($val->name) . ","; echo "'" . $val->delimiter . "',"; echo $val->attributes . "<br />\n"; } @@ -101,15 +121,19 @@ imap_close($mbox); ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>imap_getsubscribed</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_getsubscribed</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-get-quotaroot.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-get-quotaroot.xml diff -u phpdoc-fr/reference/imap/functions/imap-get-quotaroot.xml:1.9 phpdoc-fr/reference/imap/functions/imap-get-quotaroot.xml:1.10 --- phpdoc-fr/reference/imap/functions/imap-get-quotaroot.xml:1.9 Tue Jan 24 18:05:43 2006 +++ phpdoc-fr/reference/imap/functions/imap-get-quotaroot.xml Mon Jan 29 17:23:37 2007 @@ -1,61 +1,77 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.6 Maintainer: didou Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-get-quotaroot"> - <refnamediv> - <refname>imap_get_quotaroot</refname> - <refpurpose>Lit les quotas de chaque utilisateur</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>imap_get_quotaroot</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>quota_root</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_get_quotaroot</function> retourne un tableau d'entiers, - contenant les quotas de la boîte à lettres de l'utilisateur. Toutes - les valeurs sont représentées par une clé basée sur le nom de la - boîte, et par un tableau représentant le niveau d'utilisation et les - limites. - </para> - <para> - La valeur limite représente l'espace maximal alloué à l'utilisateur. - Le niveau d'utilisation représente l'occupation actuelle de la boîte. - Cette fonction retournera &false; si une erreur est survenue, et - un tableau de données si la réponse du serveur n'a pu être comprise. - </para> - <para> - Cette fonction est uniquement accessible aux utilisateurs de la bibliothèque - c-client2000 ou plus récent. - </para> - <para> - <parameter>imap_stream</parameter> est une ressource de connexion, obtenue - grâce à <function>imap_open</function>. Cette connexion doit être ouverte - avec l'identité de l'utilisateur que l'on étudie. - <parameter>quota_root</parameter> doit être un nom de boîte aux lettres - (i.e. INBOX). - </para> - <para> - <example> - <title>Exemple avec <function>imap_get_quotaroot</function></title> - <programlisting role="php"> + +<refentry id="function.imap-get-quotaroot"> + <refnamediv> + <refname>imap_get_quotaroot</refname> + <refpurpose>Lit les quotas de chaque utilisateur</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>imap_get_quotaroot</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>quota_root</parameter></methodparam> + </methodsynopsis> + <para> + Récupère les quotas de chaque utilisateur. La valeur limite représente + l'espace limite alloué pour cette utilisateur pour l'utilisation de sa boîte aux + lettres. La valeur de l'utilisation représente la taille actuelle de la boîte + aux lettres. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>quota_root</parameter></term> + <listitem> + <para> + <parameter>quota_root</parameter> doit être un nom de boîte aux lettres + (i.e. INBOX). + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau d'entiers, contenant les quotas de la boîte + aux lettres de l'utilisateur. Toutes les valeurs sont représentées + par une clé basée sur le nom de la boîte, et par un tableau + représentant le niveau d'utilisation et les limites. + </para> + <para> + Cette fonction retournera &false; si une erreur est survenue, et + un tableau de données si la réponse du serveur n'a pu être comprise. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_get_quotaroot</function></title> + <programlisting role="php"> <![CDATA[ <?php -$mbox = imap_open("{imap.example.org}","kalowsky","password",OP_HALFOPEN) - or die("can't connect: ".imap_last_error()); +$mbox = imap_open("{imap.example.org}", "kalowsky", "password", OP_HALFOPEN) + or die("Connexion impossible : " . imap_last_error()); $quota = imap_get_quotaroot($mbox, "INBOX"); -if(is_array($quota)) { +if (is_array($quota)) { $storage = $quota_values['STORAGE']; - echo "STORAGE usage level is: " . $storage['usage']; - echo "STORAGE limit level is: " . $storage['limit']; + echo "STORAGE niveau d'utilisation : " . $storage['usage']; + echo "STORAGE taille limite : " . $storage['limit']; - $message = $quota_values['MESSAGE']; + $message = $quota_values['MESSAGE']; echo "MESSAGE niveau d'utilisation : " . $message['usage']; - echo "MESSAGE niveau d'utilisation : " . $message['limit']; + echo "MESSAGE taille limite : " . $message['limit']; /* ... */ @@ -64,17 +80,33 @@ imap_close($mbox); ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>imap_open</function>, - <function>imap_set_quota</function> et - <function>imap_get_quota</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <para> + Cette fonction est uniquement accessible aux utilisateurs de la bibliothèque + c-client2000 ou plus récent. + </para> + <para> + <parameter>imap_stream</parameter> est une ressource de connexion, obtenue + grâce à <function>imap_open</function>. Cette connexion doit être ouverte + avec l'identité de l'utilisateur que l'on étudie. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_open</function></member> + <member><function>imap_set_quota</function></member> + <member><function>imap_get_quota</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-get-quota.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-get-quota.xml diff -u phpdoc-fr/reference/imap/functions/imap-get-quota.xml:1.16 phpdoc-fr/reference/imap/functions/imap-get-quota.xml:1.17 --- phpdoc-fr/reference/imap/functions/imap-get-quota.xml:1.16 Wed Sep 13 03:05:59 2006 +++ phpdoc-fr/reference/imap/functions/imap-get-quota.xml Mon Jan 29 17:23:37 2007 @@ -1,117 +1,146 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.15 Maintainer: didou Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-get-quota"> - <refnamediv> - <refname>imap_get_quota</refname> - <refpurpose> - Lit les quotas des boîtes aux lettres - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>imap_get_quota</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>quota_root</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_get_quota</function> retourne un tableau contenant - les valeurs de quota et courante de la boîte aux lettres - <parameter>quota_root</parameter>. Le quota représente la - taille maximale de votre boîte aux lettres. La valeur courante - est l'espace actuellement utilisé par votre boîte aux lettres. - <function>imap_get_quota</function> retournera &false; - en cas d'échec. - </para> - <para> - <function>imap_get_quota</function> ne fonctionne actuellement qu'avec - les bibliothèques c-client2000. - </para> - <para> - NOTE : Pour que cette fonction fonctionne, la ressource de mail doit avoir été - ouverte par un utilisateur administrateur du système de mail. Pour un utilisateur - non administrateur du système de mail, référez-vous à la fonction &php; - <function>imap_get_quotaroot</function>. - </para> - <para> - <parameter>imap_stream</parameter> doit avoir été créé - avec la fonction <function>imap_open</function>. Ce flux est - nécessairement ouvert en tant qu'administrateur du serveur, pour que - les droits nécessaires lui soient alloués. - <parameter>quota_root</parameter> doit être de la forme : - "<literal>user.nom</literal>", où "nom" est le nom de la - boîte aux lettres que vous souhaitez analyser. - </para> - <para> - <example> - <title>Exemple avec <function>imap_get_quota</function></title> - <programlisting role="php"> + +<refentry id="function.imap-get-quota"> + <refnamediv> + <refname>imap_get_quota</refname> + <refpurpose>Lit les quotas des boîtes aux lettres ainsi que des statistiques sur chacune d'elles</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>imap_get_quota</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>quota_root</parameter></methodparam> + </methodsynopsis> + <para> + Lit les quotas des boîtes aux lettres ainsi que des statistiques sur chacune d'elles. + </para> + <para> + Pour une version utilisateur, non administrateur, de cette fonction, + reportez-vous à la fonction <function>imap_get_quotaroot</function>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>quota_root</parameter></term> + <listitem> + <para> + <parameter>quota_root</parameter> doit être de la forme : + "<literal>user.nom</literal>", où "nom" est le nom de la + boîte aux lettres que vous souhaitez analyser. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau contenant les valeurs de quota et courante + de la boîte aux lettres <parameter>quota_root</parameter>. + Le quota représente la taille maximale de votre boîte aux lettres. + La valeur courante est l'espace actuellement utilisé par votre boîte + aux lettres. <function>imap_get_quota</function> retournera &false; + en cas d'échec. + </para> + <para> + Depuis &php; 4.3, la fonction reflète plus fidèlement les fonctionnalités + édictée par la <ulink url="&url.rfc;2087">RFC2087</ulink>. + Le tableau retourné a changé pour supporter un nombre illimité de + ressources retournées (i.e. messages ou sous-dossiers) avec chaque + ressource nommée qui est identifiée par une clé. Chaque clé contient + alors un autre tableau avec l'utilisation et le quota. L'exemple ci-dessous + montre comment l'utiliser. + </para> + <para> + Pour des raisons de compatibilité, la méthode d'accès originale est + toujours disponible, mais il est recommandé de l'abandonner. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_get_quota</function></title> + <programlisting role="php"> <![CDATA[ <?php -$mbox = imap_open("{imap.example.org}","mailadmin","mot de passe",OP_HALFOPEN) - or die("Connexion impossible : ".imap_last_error()); -$quota_value = imap_get_quota($mbox, "user.toto"); -if(is_array($quota_value)) { - echo "Utilisation actuelle : " . $quota_value['usage']; - echo "Quota : " . $quota_value['limit']; +$mbox = imap_open("{imap.example.org}", "mailadmin", "password", OP_HALFOPEN) + or die("Impossible de se connecter : " . imap_last_error()); + +$quota_value = imap_get_quota($mbox, "user.kalowsky"); +if (is_array($quota_value)) { + echo "Niveau d'utilisation : " . $quota_value['usage']; + echo "Quota : " . $quota_value['limit']; } + imap_close($mbox); ?> ]]> - </programlisting> - </example> - </para> - <para> - Depuis &php; 4.3, la fonction reflète plus fidèlement les fonctionnalités - édictée par la <ulink url="&url.rfc;2087">RFC2087</ulink>. - Le tableau retourné a changé pour supporter - un nombre illimité de ressources retournées (i.e. - messages ou sous-dossiers) avec chaque ressource nommée qui est identifiée - par une clé. Chaque clé contient alors un autre tableau avec l'utilisation - et le quota. L'exemple ci-dessous montre comment l'utiliser. - </para> - <para> - Pour des raisons de compatibilité, la méthode d'accès originale est - toujours disponible, mais il est recommandé de l'abandonner. - </para> - <para> - <example> - <title>Exemple avec <function>imap_get_quota</function> pour &php; 4.3</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + <example> + <title>Exemple avec <function>imap_get_quota</function> 4.3 ou supérieur</title> + <programlisting role="php"> <![CDATA[ <?php -$mbox = imap_open("{imap.example.org}","mailadmin","password",OP_HALFOPEN) - or die("Impossible de se connecter : ".imap_last_error()); +$mbox = imap_open("{imap.example.org}", "mailadmin", "password", OP_HALFOPEN) + or die("Impossible de se connecter : " . imap_last_error()); $quota_values = imap_get_quota($mbox, "user.kalowsky"); -if(is_array($quota_values)) { +if (is_array($quota_values)) { $storage = $quota_values['STORAGE']; echo "Utilisation actuelle de la capacité de stockage : " . $storage['usage']; - echo "Quota actuel de stockage : " . $storage['limit']; + echo "Quota actuel de stockage : " . $storage['limit']; - $message = $quota_values['MESSAGE']; - echo "Niveau d'utilisation de MESSAGE : " . $message['usage']; + $message = $quota_values['MESSAGE']; + echo "Niveau d'utilisation de MESSAGE : " . $message['usage']; echo "Quota de MESSAGE : " . $message['limit']; - /* ... */ -} + /* ... */ +} -imap_close($mbox); +imap_close($mbox); ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>imap_open</function>, - <function>imap_set_quota</function> et - <function>imap_get_quotaroot</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <para> + <function>imap_get_quota</function> ne fonctionne actuellement qu'avec + les bibliothèques c-client2000. + </para> + <para> + <parameter>imap_stream</parameter> doit avoir été créé + avec la fonction <function>imap_open</function>. Ce flux est + nécessairement ouvert en tant qu'administrateur du serveur, pour que + les droits nécessaires lui soient alloués. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_open</function></member> + <member><function>imap_set_quota</function></member> + <member><function>imap_get_quotaroot</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -132,4 +161,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml diff -u phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml:1.8 phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml:1.9 --- phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml:1.8 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml Mon Jan 29 17:23:37 2007 @@ -1,27 +1,106 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-getsubscribed"> - <refnamediv> - <refname>imap_getsubscribed</refname> - <refpurpose>Liste toutes les boîtes aux lettres souscrites</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>imap_getsubscribed</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>ref</parameter></methodparam> - <methodparam><type>string</type><parameter>pattern</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_getsubscribed</function> est identique à - <function>imap_getmailboxes</function>, mais ne retourne que les - boîtes aux lettres auxquelles l'utilisateur est inscrit. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-getsubscribed"> + <refnamediv> + <refname>imap_getsubscribed</refname> + <refpurpose>Liste toutes les boîtes aux lettres souscrites</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>imap_getsubscribed</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>ref</parameter></methodparam> + <methodparam><type>string</type><parameter>pattern</parameter></methodparam> + </methodsynopsis> + <para> + Liste toutes les boîtes aux lettres souscrites. + </para> + <para> + <function>imap_getsubscribed</function> est identique à + <function>imap_getmailboxes</function>, mais ne retourne que les + boîtes aux lettres auxquelles l'utilisateur est inscrit. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>ref</parameter></term> + <listitem> + <para> + <parameter>ref</parameter> ne devrait être que le serveur + sous la forme décrite dans <function>imap_open</function> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>pattern</parameter></term> + <listitem> + <para> + Spécifie la position dans la hiérarchie des boîtes aux lettres, où il faut + commencer à chercher. + </para> + <para> + Il y a deux caractères spéciaux que vous pouvez utiliser dans + <parameter>pattern</parameter> : '*' et '%'. '*' signifie : toutes les + boîtes aux lettres. Si vous passez <parameter>pattern</parameter> + comme '*', vous obtiendrez la liste complète des boîtes aux + lettres de la hiérarchie. '%' signifie qu'on ne s'interesse qu'au + niveau courant. '%' passé à <parameter>pattern</parameter> + ne retournera que les boîtes aux lettres de niveau supérieur; + '~/mail/%'.Sous UW_IMAPD retournera toutes les boîtes aux lettres du + dossier <filename>~/mail directory</filename>, mais pas leurs enfants. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau d'objets contenant les informations sur les + boîtes aux lettres. Chaque objet possède un attribut de + <parameter>name</parameter>, qui contient le nom complet + de la boîte aux lettres, <parameter>delimiter</parameter> qui + est le délimiteur hiérarchique et <parameter>attributes</parameter>. + <parameter>attributes</parameter> est un masque de bits, qui contient : + <itemizedlist> + <listitem> + <simpara> + <constant>LATT_NOINFERIORS</constant> - Cette boîte aux lettres + n'a pas d'"enfants" (il n'y a plus de boîtes aux lettres en + dessous de celle-ci). + </simpara> + </listitem> + <listitem> + <simpara> + <constant>LATT_NOSELECT</constant> - Ceci est juste un container, + pas une boîte aux lettres (vous ne pouvez pas l'ouvrir). + </simpara> + </listitem> + <listitem> + <simpara> + <constant>LATT_MARKED</constant> - Cette boîte aux lettres est marquée. + Utilisé uniquement avec UW-IMAPD. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>LATT_UNMARKED</constant> - Cette boîte aux lettres n'est pas + marquée. Utilisé uniquement avec UW-IMAPD. + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -42,4 +121,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file