cvs: phpdoc-fr /reference/imap reference.xml /reference/imap/functions imap-8bit.xml imap-append.xml imap-base64.xml imap-binary.xml imap-body.xml
imap-clearflag-full.xml imap-close.xml imap-createmailbox.xml imap-delete.xml imap-deletemailbox.xml imap-expunge.xml imap-fetch-overview.xml
imap-fetchbody.xml imap-fetchheader.xml imap-fetchstructure.xml imap-getmailboxes.xml imap-getsubscribed.xml imap-header.xml imap-listmailbox.xml
imap-listsubscribed.xml imap-mail-copy.xml imap-mail-move.xml imap-open.xml imap-ping.xml imap-qprint.xml imap-renamemailbox.xml imap-reopen.xml
imap-rfc822-parse-adrlist.xml imap-rfc822-parse-headers.xml imap-rfc822-write-address.xml imap-scanmailbox.xml imap-search.xml imap-set-quota.xml
imap-setflag-full.xml imap-sort.xml imap-subscribe.xml imap-undelete.xml imap-unsubscribe.xml
| From: | Damien Seguy | Date: | Thu, 06 Feb 2003 03:49:01 +0000 |
| Subject: | cvs: phpdoc-fr /reference/imap reference.xml /reference/imap/functions imap-8bit.xml imap-append.xml imap-base64.xml imap-binary.xml imap-body.xml imap-clearflag-full.xml imap-close.xml imap-createmailbox.xml imap-delete.xml imap-deletemailbox.xml imap-expunge.xml imap-fetch-overview.xml imap-fetchbody.xml imap-fetchheader.xml imap-fetchstructure.xml imap-getmailboxes.xml imap-getsubscribed.xml imap-header.xml imap-listmailbox.xml imap-listsubscribed.xml imap-mail-copy.xml imap-mail-move.xml imap-open.xml imap-ping.xml imap-qprint.xml imap-renamemailbox.xml imap-reopen.xml imap-rfc822-parse-adrlist.xml imap-rfc822-parse-headers.xml imap-rfc822-write-address.xml imap-scanmailbox.xml imap-search.xml imap-set-quota.xml imap-setflag-full.xml imap-sort.xml imap-subscribe.xml imap-undelete.xml imap-unsubscribe.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-210@lists.php.net to get a copy of this message | ||
dams Wed Feb 5 22:49:01 2003 EDT
Modified files:
/phpdoc-fr/reference/imap reference.xml
/phpdoc-fr/reference/imap/functions imap-8bit.xml imap-append.xml
imap-base64.xml imap-binary.xml
imap-body.xml
imap-clearflag-full.xml
imap-close.xml
imap-createmailbox.xml
imap-delete.xml
imap-deletemailbox.xml
imap-expunge.xml
imap-fetch-overview.xml
imap-fetchbody.xml
imap-fetchheader.xml
imap-fetchstructure.xml
imap-getmailboxes.xml
imap-getsubscribed.xml
imap-header.xml
imap-listmailbox.xml
imap-listsubscribed.xml
imap-mail-copy.xml
imap-mail-move.xml
imap-open.xml imap-ping.xml
imap-qprint.xml
imap-renamemailbox.xml
imap-reopen.xml
imap-rfc822-parse-adrlist.xml
imap-rfc822-parse-headers.xml
imap-rfc822-write-address.xml
imap-scanmailbox.xml
imap-search.xml
imap-set-quota.xml
imap-setflag-full.xml
imap-sort.xml
imap-subscribe.xml
imap-undelete.xml
imap-unsubscribe.xml
Log:
spring cleaning
Index: phpdoc-fr/reference/imap/reference.xml diff -u phpdoc-fr/reference/imap/reference.xml:1.3 phpdoc-fr/reference/imap/reference.xml:1.4 --- phpdoc-fr/reference/imap/reference.xml:1.3 Mon Nov 18 10:18:21 2002 +++ phpdoc-fr/reference/imap/reference.xml Wed Feb 5 22:49:00 2003 @@ -1,15 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <reference id="ref.imap"> <title>IMAP</title> <titleabbrev>IMAP</titleabbrev> - <partintro> - <simpara> - Pour avoir accès à ces fonctions, vous devez compiler PHP - avec l'option <link linkend="install.configure.with-imap"><option role="configure">--with-imap</option></link>. - Il faut avoir installé la librairie C-client. - Chargez sa dernière version sur le serveur - <ulink url="&url.imap;">&url.imap;</ulink> et compilez la. + <partintro> + <section id="imap.intro"> + &reftitle.intro; + <para> + These functions are not limited to the <acronym>IMAP</acronym> protocol, + despite their name. The underlying c-client library also supports + <acronym>NNTP</acronym>, <acronym>POP3</acronym> and local mailbox access + methods. + </para> + </section> + + <section id="imap.requirements"> + &reftitle.required; + <para> + Cette extension requiert la librairie C cliente. Téléchargez + cette dernière version à <ulink url="&url.imap;">&url.imap;</ulink> + et compilez la. + </para> + <para> Puis, copiez le fichier <filename>c-client/c-client.a</filename> dans <filename>/usr/local/lib</filename> ou n'importe quel autre dossier qui soit dans le chemin de link. Enfin, copiez les fichiers @@ -17,20 +29,69 @@ et <filename>linkage.h</filename> dans <filename>/usr/local/include</filename> ou n'importe quel autre dossier qui soit dans le chemin d'inclusion. - </simpara> - <simpara> - Ces fonctions ne sont pas limitées au protocole - <acronym>IMAP</acronym>, malgré leur nom. La librairie sur laquelle - elles sont développées supporte aussi <acronym>NNTP</acronym>, - <acronym>POP3</acronym> et les méthodes d'accès aux - boîtes aux lettres locales. Reportez-vous à la fonction - <function>imap_open</function> pour plus d'informations. - </simpara> - <para> + </para> + <note> + <para> + Assurez vous que <filename>c-client.a</filename> est bien dans votre + chemin de link, sous le nom <filename>libc-client.a</filename>. + </para> + </note> + <para> + Copiez les fichiers suivants dans le dossier + <filename>/usr/local/include</filename> ou dans n'importe quel + dossier qui soit dans votre chemin d'inclusion. + <simplelist> + <member><filename>c-client.h</filename></member> + <member><filename>imap4r1.h</filename></member> + <member><filename>rfc822.h</filename></member> + <member><filename>mail.h</filename></member> + <member><filename>linkage.h</filename></member> + <member><filename>env.h</filename></member> + <member><filename>env_unix.h</filename></member> + <member><filename>fs.h</filename></member> + <member><filename>ftl.h</filename></member> + <member><filename>misc.h</filename></member> + <member><filename>nntp.h</filename></member> + <member><filename>nl.h</filename></member> + <member><filename>osdep.h</filename></member> + <member><filename>smtp.h</filename></member> + <member><filename>tcp.h</filename></member> + </simplelist> + </para> + <note> + <para> + Le nom de <filename>env_unix.h</filename> dépend de votre OS. + Assurez vous que ces fichiers sont bien copiés avec l'option + de suivi des liens. Pour compiler la librairie C cliente avec + SSL et/ou avec le support Kerberos, lisez la doc fournie dans + la distribution. + </para> + </note> + </section> + + &reference.imap.configure; + + <section id="imap.configuration"> + &reftitle.runtime; + &no.config; + </section> + + <section id="imap.resources"> + &reftitle.resources; + <para> + </para> + </section> + + &reference.imap.constants; + + <section id="imap.seealso"> + &reftitle.seealso; + <para> Ce document ne peut entrer dans les détails de toutes les sujets abordés. Plus d'informations sont disponibles avec la documentation de la librairie C (<filename>docs/internal.txt</filename>) ainsi que les RFC suivantes : + documents: <itemizedlist> <listitem> <simpara> @@ -84,8 +145,17 @@ <ulink url="&url.email.book;">Programming Internet Email</ulink> par David Wood et <ulink url="&url.imap.book;">Managing IMAP</ulink> par Dianna Mullet & Kevin Mullet. - </para> - </partintro> + </para> + <warning> + <para> + Des crashs et des problèmes de démarrage de &php; sont possibles lorsque + vous chargez cette extension en même temps que l'extension recode. + Voyez l'extension <link linkend="ref.recode">recode</link> pour plus + d'informations. + </para> + </warning> + </section> + </partintro> &reference.imap.functions; Index: phpdoc-fr/reference/imap/functions/imap-8bit.xml diff -u phpdoc-fr/reference/imap/functions/imap-8bit.xml:1.1 phpdoc-fr/reference/imap/functions/imap-8bit.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-8bit.xml:1.1 Sun Apr 14 20:30:53 2002 +++ phpdoc-fr/reference/imap/functions/imap-8bit.xml Wed Feb 5 22:49:01 2003 @@ -17,7 +17,8 @@ </methodsynopsis> <para> <function>imap_8bit</function> convertit la chaîne à 8 bits - en une chaîne à guillemets. + en une chaîne à guillemets + (selon la <ulink url="&url.rfc;rfc2045.html">RFC 2045</ulink>, Section 6.7). </para> <para> <function>imap_8bit</function> retourne une chaîne à Index: phpdoc-fr/reference/imap/functions/imap-append.xml diff -u phpdoc-fr/reference/imap/functions/imap-append.xml:1.1 phpdoc-fr/reference/imap/functions/imap-append.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-append.xml:1.1 Sun Apr 14 20:30:53 2002 +++ phpdoc-fr/reference/imap/functions/imap-append.xml Wed Feb 5 22:49:01 2003 @@ -10,13 +10,13 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</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><type>string</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <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'option @@ -25,8 +25,7 @@ aux lettres. </para> <para> - <function>imap_append</function> retourne &true; - en cas de succès, et &false; en cas d'erreur. + &return.sucess; </para> <para> Lors des échanges avec le serveur Cyrus IMAP, vous devrez utiliser @@ -37,13 +36,14 @@ <example> <title>Exemple avec <function>imap_append</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $stream = imap_open("{your.imap.host}INBOX.Drafts","username", "password"); $check = imap_check($stream); print "Nombre de message avant ajout : ". $check->Nmsgs."\n"; imap_append($stream,"{your.imap.host}INBOX.Drafts" - ,"From: me@my.host\r\n" - ."To: you@your.host\r\n" + ,"From: moi@mon.hote\r\n" + ."To: toi@ton.hote\r\n" ."Subject: test\r\n" ."\r\n" ."Ceci est un message de test. Ignorez le\r\n" @@ -51,7 +51,8 @@ $check = imap_check($stream); print "Nombre de message après ajout : ". $check->Nmsgs."\n"; imap_close($stream); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-base64.xml diff -u phpdoc-fr/reference/imap/functions/imap-base64.xml:1.1 phpdoc-fr/reference/imap/functions/imap-base64.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-base64.xml:1.1 Sun Apr 14 20:30:53 2002 +++ phpdoc-fr/reference/imap/functions/imap-base64.xml Wed Feb 5 22:49:01 2003 @@ -4,7 +4,7 @@ <refentry id="function.imap-base64"> <refnamediv> <refname>imap_base64</refname> - <refpurpose>Décode un texte encodé en BASE64.</refpurpose> + <refpurpose>Décode un texte encodé en BASE64</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -15,7 +15,8 @@ <para> <function>imap_base64</function> décode un texte encodé en BASE64. Le texte décodé est retourné sous la - forme d'une chaîne. + forme d'une chaîne + (selon la <ulink url="&url.rfc;rfc2045.html">RFC 2045</ulink>, Section 6.8). </para> </refsect1> </refentry> Index: phpdoc-fr/reference/imap/functions/imap-binary.xml diff -u phpdoc-fr/reference/imap/functions/imap-binary.xml:1.1 phpdoc-fr/reference/imap/functions/imap-binary.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-binary.xml:1.1 Sun Apr 14 20:30:53 2002 +++ phpdoc-fr/reference/imap/functions/imap-binary.xml Wed Feb 5 22:49:01 2003 @@ -17,7 +17,8 @@ </methodsynopsis> <para> <function>imap_binary</function> convertit la chaîne à - 8 bits <parameter>string</parameter> en une chaîne à base64. + 8 bits <parameter>string</parameter> en une chaîne à base64 + (selon la <ulink url="&url.rfc;rfc2045.html">RFC 2045</ulink>, Section 6.8). </para> <para> <function>imap_binary</function> retourne la chaîne codée. Index: phpdoc-fr/reference/imap/functions/imap-body.xml diff -u phpdoc-fr/reference/imap/functions/imap-body.xml:1.1 phpdoc-fr/reference/imap/functions/imap-body.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-body.xml:1.1 Sun Apr 14 20:30:54 2002 +++ phpdoc-fr/reference/imap/functions/imap-body.xml Wed Feb 5 22:49:01 2003 @@ -4,16 +4,16 @@ <refentry id="function.imap-body"> <refnamediv> <refname>imap_body</refname> - <refpurpose>Lit le corps d'un message.</refpurpose> + <refpurpose>Lit le corps d'un message</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <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><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <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. Index: phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml diff -u phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml:1.1 phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml:1.1 Sun Apr 14 20:30:54 2002 +++ phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml Wed Feb 5 22:49:01 2003 @@ -4,21 +4,24 @@ <refentry id="function.imap-clearflag-full"> <refnamediv> <refname>imap_clearflag_full</refname> - <refpurpose>Supprime un flag sur un message.</refpurpose> + <refpurpose>Supprime un flag sur un message</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>string</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><type>string</type><parameter>options</parameter></methodparam> - </methodsynopsis> + <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><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 flot imap <parameter>stream</parameter>. + Les flags <parameter>flag</parameter> que vous pouvez effacer sont + "\\Seen", "\\Answered", "\\Flagged", "\\Deleted" et "\\Draft" (tels + que dfinis dans la RFC2060). </para> <para> Les options sont un masque de bit, qui accepte les valeurs suivantes : Index: phpdoc-fr/reference/imap/functions/imap-close.xml diff -u phpdoc-fr/reference/imap/functions/imap-close.xml:1.1 phpdoc-fr/reference/imap/functions/imap-close.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-close.xml:1.1 Sun Apr 14 20:30:54 2002 +++ phpdoc-fr/reference/imap/functions/imap-close.xml Wed Feb 5 22:49:01 2003 @@ -4,15 +4,15 @@ <refentry id="function.imap-close"> <refnamediv> <refname>imap_close</refname> - <refpurpose>Termine un flot IMAP.</refpurpose> + <refpurpose>Termine un flot IMAP</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_close</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <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 flot <acronym>IMAP</acronym>. <function>imap_close</function> prend un argument optionnel Index: phpdoc-fr/reference/imap/functions/imap-createmailbox.xml diff -u phpdoc-fr/reference/imap/functions/imap-createmailbox.xml:1.1 phpdoc-fr/reference/imap/functions/imap-createmailbox.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-createmailbox.xml:1.1 Sun Apr 14 20:30:54 2002 +++ phpdoc-fr/reference/imap/functions/imap-createmailbox.xml Wed Feb 5 22:49:01 2003 @@ -4,15 +4,15 @@ <refentry id="function.imap-createmailbox"> <refnamediv> <refname>imap_createmailbox</refname> - <refpurpose>Crée une nouvelle boîte aux lettres.</refpurpose> + <refpurpose>Crée une nouvelle boîte aux lettres</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_createmailbox</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>mbox</parameter></methodparam> - </methodsynopsis> + <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 @@ -27,44 +27,46 @@ <example> <title>Exemple avec <function>imap_createmailbox</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open("{your.imap.host}","utilisateur","mot_de_passe",OP_HALFOPEN) or die("connexion impossible: ".imap_last_error()); $name1 = "nouvellephpbox"; $name2 = imap_utf7_encode("nouvellephpboxéx"); $newname = $name1; -echo "Le nouveau nom sera '$name1'<br>\n"; -# 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. +echo "Le nouveau nom sera '$name1'<BR>\n"; +// 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("{your.imap.host}INBOX.$newname"))){ $status = @imap_status($mbox,"{your.imap.host}INBOX.$newname",SA_ALL); if($status) { - print("Votre nouvelle boîte '$name1' est dans l'état suivant :<br>\n"); - print("Messages: ". $status->messages )."<br>\n"; - print("Récent: ". $status->recent )."<br>\n"; - print("Non lus: ". $status->unseen )."<br>\n"; - print("UID suivant: ". $status->uidnext )."<br>\n"; - print("UID validité:". $status->uidvalidity)."<br>\n"; + print("Votre nouvelle boîte '$name1' est dans l'état suivant :<BR>\n"); + print("Messages: ". $status->messages )."<BR>\n"; + print("Récent: ". $status->recent )."<BR>\n"; + print("Non lus: ". $status->unseen )."<BR>\n"; + print("UID suivant: ". $status->uidnext )."<BR>\n"; + print("UID validité:". $status->uidvalidity)."<BR>\n"; if(imap_renamemailbox($mbox,"{your.imap.host}INBOX.$newname","{your.imap.host}INBOX.$name2")) { - echo "renommage de la boîte aux lettres '$name1' en '$name2'<br>\n"; + echo "renommage de la boîte aux lettres '$name1' en '$name2'<BR>\n"; $newname=$name2; } else { - print "imap_renamemailbox sur la nouvelle boîte aux lettres a échoué : ".imap_last_error()."<br>\n"; + print "imap_renamemailbox sur la nouvelle boîte aux lettres a échoué : ".imap_last_error()."<BR>\n"; } } else { - print "imap_status sur la nouvelle boîte aux lettres a échoué : ".imap_last_error()."<br>\n"; + print "imap_status sur la nouvelle boîte aux lettres a échoué : ".imap_last_error()."<BR>\n"; } if(@imap_deletemailbox($mbox,"{your.imap.host}INBOX.$newname")) { - print "new mailbox supprimée pour remettre tout en état<br>\n"; + print "new mailbox supprimée pour remettre tout en état<BR>\n"; } else { - print "imap_deletemailbox ur la nouvelle boîte aux lettres a échoué : ".implode("<br>\n",imap_errors())."<br>\n"; + print "imap_deletemailbox ur la nouvelle boîte aux lettres a échoué : ".implode("<BR>\n",imap_errors())."<BR>\n"; } } else { - print "Impossible de créer une nouvelle boîte aux lettres : ".implode("<br>\n",imap_errors())."<br>\n"; + print "Impossible de créer une nouvelle boîte aux lettres : ".implode("<BR>\n",imap_errors())."<BR>\n"; } imap_close($mbox); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-delete.xml diff -u phpdoc-fr/reference/imap/functions/imap-delete.xml:1.1 phpdoc-fr/reference/imap/functions/imap-delete.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-delete.xml:1.1 Sun Apr 14 20:30:54 2002 +++ phpdoc-fr/reference/imap/functions/imap-delete.xml Wed Feb 5 22:49:01 2003 @@ -5,20 +5,17 @@ <refnamediv> <refname>imap_delete</refname> <refpurpose> - Marque le fichier pour l'effacement, dans la boîte aux lettres courante. + Marque le fichier pour l'effacement, dans la boîte aux lettres courante </refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_delete</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>flags</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_delete</function> retourne &true;. - </para> + <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> marque le fichier <parameter>msg_number</parameter> pour l'effacement, dans la @@ -30,22 +27,27 @@ <function>imap_expunge</function>. </para> <para> + <function>imap_delete</function> retourne &true;. + </para> + <para> <example> - <title>Exemple <function>imap_delete</function></title> + <title>Exemple avec <function>imap_delete</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open ("{your.imap.host}INBOX", "utilisateur", "mot_de_passe") or die ("connexion impossible: " . imap_last_error()); $check = imap_mailboxmsginfo ($mbox); -print "Nombre de messages avant effacement : " . $check->Nmsgs . "<br>\n" ; +print "Nombre de messages avant effacement : " . $check->Nmsgs . "<BR>\n" ; imap_delete ($mbox, 1); $check = imap_mailboxmsginfo ($mbox); -print "Nombre de messages après effacement: " . $check->Nmsgs . "<br>\n" ; +print "Nombre de messages après effacement: " . $check->Nmsgs . "<BR>\n" ; imap_expunge ($mbox); $check = imap_mailboxmsginfo ($mbox); -print "Nombre de messages après imap_expunge: " . $check->Nmsgs . "<br>\n" ; +print "Nombre de messages après imap_expunge: " . $check->Nmsgs . "<BR>\n" ; imap_close ($mbox); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml diff -u phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml:1.1 phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml:1.1 Sun Apr 14 20:30:55 2002 +++ phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml Wed Feb 5 22:49:01 2003 @@ -4,15 +4,15 @@ <refentry id="function.imap-deletemailbox"> <refnamediv> <refname>imap_deletemailbox</refname> - <refpurpose>Efface une boîte aux lettres.</refpurpose> + <refpurpose>Efface une boîte aux lettres</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_deletemailbox</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>mbox</parameter></methodparam> - </methodsynopsis> + <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 (voir <function>imap_open</function> pour connaître le format Index: phpdoc-fr/reference/imap/functions/imap-expunge.xml diff -u phpdoc-fr/reference/imap/functions/imap-expunge.xml:1.1 phpdoc-fr/reference/imap/functions/imap-expunge.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-expunge.xml:1.1 Sun Apr 14 20:30:55 2002 +++ phpdoc-fr/reference/imap/functions/imap-expunge.xml Wed Feb 5 22:49:01 2003 @@ -10,10 +10,10 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_expunge</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - </methodsynopsis> + <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>. Index: phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml diff -u phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml:1.1 phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml:1.1 Sun Apr 14 20:30:55 2002 +++ phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml Wed Feb 5 22:49:01 2003 @@ -10,12 +10,12 @@ </refnamediv> <refsect1> <title>Description</title> - <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>flags</parameter></methodparam> - </methodsynopsis> + <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 @@ -100,21 +100,26 @@ <example> <title>Exemple avec <function>imap_fetch_overview</function></title> <programlisting role="php"> -<?php -$mbox = imap_open("{votre.hote.imap}","utilisateur","mot_de_passe") +<![CDATA[ +<?php +$mbox = imap_open("{your.imap.host:143}","username","password") or die("connexion impossible : ".imap_last_error()); + $overview = imap_fetch_overview($mbox,"2,4:6",0); + if(is_array($overview)) { - reset($overview); - while( list($key,$val) = each($overview)) { - print $val->msgno - . " - " . $val->date - . " - " . $val->subject - . "\n"; - } + reset($overview); + while( list($key,$val) = each($overview)) { + print $val->msgno + . " - " . $val->date + . " - " . $val->subject + . "\n"; + } } + imap_close($mbox); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-fetchbody.xml diff -u phpdoc-fr/reference/imap/functions/imap-fetchbody.xml:1.1 phpdoc-fr/reference/imap/functions/imap-fetchbody.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-fetchbody.xml:1.1 Sun Apr 14 20:30:56 2002 +++ phpdoc-fr/reference/imap/functions/imap-fetchbody.xml Wed Feb 5 22:49:01 2003 @@ -4,17 +4,17 @@ <refentry id="function.imap-fetchbody"> <refnamediv> <refname>imap_fetchbody</refname> - <refpurpose>Retourne une section extraite du corps d'un message.</refpurpose> + <refpurpose>Retourne une section extraite du corps d'un message</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <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>flags</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <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>flags</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 @@ -46,6 +46,10 @@ </listitem> </itemizedlist> </para> + <para> + Voir aussi + <function>imap_fetchstructure</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/imap/functions/imap-fetchheader.xml diff -u phpdoc-fr/reference/imap/functions/imap-fetchheader.xml:1.1 phpdoc-fr/reference/imap/functions/imap-fetchheader.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-fetchheader.xml:1.1 Sun Apr 14 20:30:56 2002 +++ phpdoc-fr/reference/imap/functions/imap-fetchheader.xml Wed Feb 5 22:49:01 2003 @@ -4,19 +4,20 @@ <refentry id="function.imap-fetchheader"> <refnamediv> <refname>imap_fetchheader</refname> - <refpurpose>Retourne l'en-tête d'un message.</refpurpose> + <refpurpose>Retourne l'en-tête d'un message</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <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><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <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><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> <para> <function>imap_fetchheader</function> retourne l'en-tête brute et - complète RFC 822 du message <parameter>msgno</parameter>, et le retourne + complète <ulink url="&url.rfc;rfc2822.html">RFC2822</ulink> + du message <parameter>msgno</parameter>, et le retourne sous la forme d'une chaîne. </para> <para> Index: phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml diff -u phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml:1.1 phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml:1.1 Sun Apr 14 20:30:56 2002 +++ phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml Wed Feb 5 22:49:01 2003 @@ -10,12 +10,12 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>object</type><methodname>imap_fetchstructure</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>flags</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>object</type><methodname>imap_fetchstructure</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_fetchstructure</function> la structure du message <parameter>msg_number</parameter>. <function>imap_fetchstructure</function> Index: phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml diff -u phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml:1.1 phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml:1.1 Sun Apr 14 20:30:56 2002 +++ phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml Wed Feb 5 22:49:01 2003 @@ -10,12 +10,12 @@ </refnamediv> <refsect1> <title>Description</title> - <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>pat</parameter></methodparam> - </methodsynopsis> + <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 a les attributs @@ -73,23 +73,25 @@ <example> <title>Exemple avec <function>imap_getmailboxes</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open("{your.imap.host}","utilisateur","mot_de_passe",OP_HALFOPEN) - or die("connexion impossible: ".imap_last_error()); -$list = imap_getmailboxes($mbox,"{your.imap.host}","*"); + or die("connexion impossible : ".imap_last_error()); +$list = imap_getmailboxes($mbox,"{votre.hote.imap}","*"); if(is_array($list)) { - reset($list); - while (list($key, $val) = each($list)) - { + reset($list); + while (list($key, $val) = each($list)) { print "($key) "; print imap_utf7_decode($val->name).","; print "'".$val->delimiter."',"; - print $val->attributes."<br>\n"; - } -} else - print "imap_getmailboxes a échoué : ".imap_last_error()."\n"; + print $val->attributes."<BR>\n"; + } +} else { + print "imap_getmailboxes a échoué : ".imap_last_error()."\n"; +} imap_close($mbox); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml diff -u phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml:1.1 phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml:1.1 Sun Apr 14 20:30:57 2002 +++ phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml Wed Feb 5 22:49:01 2003 @@ -4,16 +4,16 @@ <refentry id="function.imap-getsubscribed"> <refnamediv> <refname>imap_getsubscribed</refname> - <refpurpose>Liste toutes les boîtes aux lettres souscrites.</refpurpose> + <refpurpose>Liste toutes les boîtes aux lettres souscrites</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <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> + <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 Index: phpdoc-fr/reference/imap/functions/imap-header.xml diff -u phpdoc-fr/reference/imap/functions/imap-header.xml:1.1 phpdoc-fr/reference/imap/functions/imap-header.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-header.xml:1.1 Sun Apr 14 20:30:57 2002 +++ phpdoc-fr/reference/imap/functions/imap-header.xml Wed Feb 5 22:49:01 2003 @@ -4,7 +4,7 @@ <refentry id="function.imap-header"> <refnamediv> <refname>imap_header</refname> - <refpurpose>Lit l'en-tête d'un message.</refpurpose> + <refpurpose>Lit l'en-tête d'un message</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/imap/functions/imap-listmailbox.xml diff -u phpdoc-fr/reference/imap/functions/imap-listmailbox.xml:1.1 phpdoc-fr/reference/imap/functions/imap-listmailbox.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-listmailbox.xml:1.1 Sun Apr 14 20:30:58 2002 +++ phpdoc-fr/reference/imap/functions/imap-listmailbox.xml Wed Feb 5 22:49:01 2003 @@ -4,16 +4,16 @@ <refentry id="function.imap-listmailbox"> <refnamediv> <refname>imap_listmailbox</refname> - <refpurpose>Liste les boîtes aux lettres.</refpurpose> + <refpurpose>Liste les boîtes aux lettres</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>imap_listmailbox</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>ref</parameter></methodparam> - <methodparam><type>string</type><parameter>pat</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>imap_listmailbox</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_listmailbox</function> retourne un tableau contenant les noms des boîtes aux lettres. @@ -22,7 +22,8 @@ <example> <title>Exemple avec <function>imap_listmailbox</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open("{your.imap.host}","utilisateur","mot_de_passe",OP_HALFOPEN) or die("connexion impossible: ".imap_last_error()); $list = imap_listmailbox($mbox,"{your.imap.host}","*"); @@ -33,7 +34,8 @@ } else print "imap_listmailbox a échoué: ".imap_last_error()."\n"; imap_close($mbox); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-listsubscribed.xml diff -u phpdoc-fr/reference/imap/functions/imap-listsubscribed.xml:1.1 phpdoc-fr/reference/imap/functions/imap-listsubscribed.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-listsubscribed.xml:1.1 Sun Apr 14 20:30:58 2002 +++ phpdoc-fr/reference/imap/functions/imap-listsubscribed.xml Wed Feb 5 22:49:01 2003 @@ -4,7 +4,7 @@ <refentry id="function.imap-listsubscribed"> <refnamediv> <refname>imap_listsubscribed</refname> - <refpurpose>Liste les boîtes aux lettres souscrites.</refpurpose> + <refpurpose>Liste les boîtes aux lettres souscrites</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/imap/functions/imap-mail-copy.xml diff -u phpdoc-fr/reference/imap/functions/imap-mail-copy.xml:1.1 phpdoc-fr/reference/imap/functions/imap-mail-copy.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-mail-copy.xml:1.1 Sun Apr 14 20:30:58 2002 +++ phpdoc-fr/reference/imap/functions/imap-mail-copy.xml Wed Feb 5 22:49:01 2003 @@ -10,19 +10,20 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_mail_copy</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>msglist</parameter></methodparam> - <methodparam><type>string</type><parameter>mbox</parameter></methodparam> - <methodparam><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_mail_copy</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>msglist</parameter></methodparam> + <methodparam><type>string</type><parameter>mbox</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> <para> <function>imap_mail_copy</function> copie les messages email spécifiés par <parameter>msglist</parameter> dans la boîte aux lettres nommée <parameter>mbox</parameter>. <parameter>msglist</parameter> est un intervalle, et pas seulement - une liste numéros de message. + une liste numéros de message (comme décrit dans la + <ulink url="&url.rfc;rfc2060.html">RFC2060</ulink>). </para> <para> <function>imap_mail_copy</function> retourne &true; Index: phpdoc-fr/reference/imap/functions/imap-mail-move.xml diff -u phpdoc-fr/reference/imap/functions/imap-mail-move.xml:1.1 phpdoc-fr/reference/imap/functions/imap-mail-move.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-mail-move.xml:1.1 Sun Apr 14 20:30:58 2002 +++ phpdoc-fr/reference/imap/functions/imap-mail-move.xml Wed Feb 5 22:49:01 2003 @@ -5,26 +5,29 @@ <refnamediv> <refname>imap_mail_move</refname> <refpurpose> - Déplace les messages spécifiés - dans une boîte aux lettres. + Déplace des messages dans une boîte aux lettres </refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_mail_move</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>msglist</parameter></methodparam> - <methodparam><type>string</type><parameter>mbox</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_mail_move</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>msglist</parameter></methodparam> + <methodparam><type>string</type><parameter>mbox</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> <para> <function>imap_mail_move</function> déplace les messages spécifiés par <parameter>msglist</parameter> dans la boîte aux lettres <parameter>mbox</parameter>. <parameter>msglist</parameter> est un intervalle, et pas seulement une - liste de messages. + liste de messages (comme décrit dans la + <ulink url="&url.rfc;rfc2060.html">RFC2060</ulink>). </para> + <para> + &return.success; + </para> <para> <parameter>flags</parameter> est un champs de bit et peut contenir une seule valeur : @@ -35,10 +38,6 @@ </simpara> </listitem> </itemizedlist> - </para> - <para> - <function>imap_mail_move</function> retourne &true; - en cas de succès, et &false; en cas d'erreur. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/imap/functions/imap-open.xml diff -u phpdoc-fr/reference/imap/functions/imap-open.xml:1.1 phpdoc-fr/reference/imap/functions/imap-open.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-open.xml:1.1 Sun Apr 14 20:30:59 2002 +++ phpdoc-fr/reference/imap/functions/imap-open.xml Wed Feb 5 22:49:01 2003 @@ -4,17 +4,17 @@ <refentry id="function.imap-open"> <refnamediv> <refname>imap_open</refname> - <refpurpose>Ouvre un flot IMAP vers une boîte aux lettres.</refpurpose> + <refpurpose>Ouvre un flot IMAP vers une boîte aux lettres</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_open</methodname> - <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> - <methodparam><type>string</type><parameter>username</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>resource</type><methodname>imap_open</methodname> + <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> + <methodparam><type>string</type><parameter>username</parameter></methodparam> + <methodparam><type>string</type><parameter>password</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> <para> <function>imap_open</function> retourne un flot <acronym>IMAP</acronym> en cas de succès, et &false; en cas d'erreur. @@ -66,45 +66,55 @@ commande suivante : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open("{localhost:143}INBOX","user_id","password"); -?> +?> +]]> </programlisting> </informalexample> Pour se connecter à un serveur <acronym>POP3</acronym> qui fonctionne sur le port 110 de la machine locale on peut utiliser la commande suivante : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open("{localhost:110/pop3}INBOX","user_id","password"); -?> +?> +]]> </programlisting> </informalexample> Pour se connecter à un serveur IMAP SSL ou POP3 SSL, ajoutez <literal>/ssl</literal> après le protocole : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open ("{localhost:993/imap/ssl}INBOX", "user_id", "password"); -?> +?> +]]> </programlisting> </informalexample> Pour se connecter à un serveur SSL IMAP ou POP3 avec un certificat ajoutez <literal>/ssl/novalidate-cert</literal> après le protocole : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open ("{localhost:995/pop3/ssl/novalidate-cert}", "user_id", "password"); -?> +?> +]]> </programlisting> </informalexample> Pour se connecter à un serveur <acronym>NNTP</acronym> qui fonctionne sur le port 119 de la machine locale on peut utiliser la commande: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $nntp = imap_open("{localhost:119/nntp}comp.test","",""); -?> +?> +]]> </programlisting> </informalexample> Pour se connecter à un serveur distant, remplacez "localhost" par @@ -114,7 +124,8 @@ <example> <title>Exemple avec <function>imap_open</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open ("{votre.hote.imap:143}", "nom_utilisateur", "mot de passe"); echo "<p><h1>Mailboxes</h1>\n"; $folders = imap_listmailbox ($mbox, "{votre.hote.imap:143}", "*"); @@ -135,7 +146,8 @@ } } imap_close($mbox); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-ping.xml diff -u phpdoc-fr/reference/imap/functions/imap-ping.xml:1.1 phpdoc-fr/reference/imap/functions/imap-ping.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-ping.xml:1.1 Sun Apr 14 20:31:00 2002 +++ phpdoc-fr/reference/imap/functions/imap-ping.xml Wed Feb 5 22:49:01 2003 @@ -4,17 +4,17 @@ <refentry id="function.imap-ping"> <refnamediv> <refname>imap_ping</refname> - <refpurpose>Vérifie que le flot IMAP est toujours actif.</refpurpose> + <refpurpose>Vérifie que le flot IMAP est toujours actif</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_ping</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_ping</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + </methodsynopsis> <para> <function>imap_ping</function> retourne &true; si - le flot <parameter>imap_stream</parameter> existe toujours, + le flt <parameter>imap_stream</parameter> existe toujours, et &false; sinon. </para> <para> Index: phpdoc-fr/reference/imap/functions/imap-qprint.xml diff -u phpdoc-fr/reference/imap/functions/imap-qprint.xml:1.1 phpdoc-fr/reference/imap/functions/imap-qprint.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-qprint.xml:1.1 Sun Apr 14 20:31:00 2002 +++ phpdoc-fr/reference/imap/functions/imap-qprint.xml Wed Feb 5 22:49:01 2003 @@ -18,7 +18,8 @@ <para> <function>imap_qprint</function> convertit la chaîne à guillemets <parameter>string</parameter> en une chaîne à - 8 bits. + 8 bits (selon la <ulink url="&url.rfc;rfc2045.html">RFC2045</ulink>, section + 6.7). </para> <para> <function>imap_qprint</function> retourne une chaîne 8 bits (binaire). Index: phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml diff -u phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml:1.1 phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml:1.1 Sun Apr 14 20:31:00 2002 +++ phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml Wed Feb 5 22:49:01 2003 @@ -4,23 +4,22 @@ <refentry id="function.imap-renamemailbox"> <refnamediv> <refname>imap_renamemailbox</refname> - <refpurpose>Renomme une boîte aux lettres.</refpurpose> + <refpurpose>Renomme une boîte aux lettres</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_renamemailbox</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>old_mbox</parameter></methodparam> - <methodparam><type>string</type><parameter>new_mbox</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_renamemailbox</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>old_mbox</parameter></methodparam> + <methodparam><type>string</type><parameter>new_mbox</parameter></methodparam> + </methodsynopsis> <para> <function>imap_renamemailbox</function> renomme la boîte aux lettres <parameter>old_mbox</parameter> en <parameter>new_mbox</parameter>. </para> <para> - <function>imap_renamemailbox</function> retourne &true; - en cas de succès, et &false; en cas d'erreur. + &return.success; </para> <para> Voir aussi Index: phpdoc-fr/reference/imap/functions/imap-reopen.xml diff -u phpdoc-fr/reference/imap/functions/imap-reopen.xml:1.1 phpdoc-fr/reference/imap/functions/imap-reopen.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-reopen.xml:1.1 Sun Apr 14 20:31:00 2002 +++ phpdoc-fr/reference/imap/functions/imap-reopen.xml Wed Feb 5 22:49:01 2003 @@ -10,12 +10,12 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_reopen</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_reopen</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>options</parameter></methodparam> + </methodsynopsis> <para> <function>imap_reopen</function> réouvre la connexion spécifiée au serveur <acronym>IMAP</acronym> ou <acronym>NNTP</acronym>, @@ -49,6 +49,9 @@ </listitem> </itemizedlist> </para> + <para> + &return.success; + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml diff -u phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml:1.1 phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml:1.1 Sun Apr 14 20:31:01 2002 +++ phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml Wed Feb 5 22:49:01 2003 @@ -4,19 +4,20 @@ <refentry id="function.imap-rfc822-parse-adrlist"> <refnamediv> <refname>imap_rfc822_parse_adrlist</refname> - <refpurpose>Analyse une chaîne d'adresse.</refpurpose> + <refpurpose>Analyse une adresse email</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>imap_rfc822_parse_adrlist</methodname> - <methodparam><type>string</type><parameter>address</parameter></methodparam> - <methodparam><type>string</type><parameter>default_host</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>imap_rfc822_parse_adrlist</methodname> + <methodparam><type>string</type><parameter>address</parameter></methodparam> + <methodparam><type>string</type><parameter>default_host</parameter></methodparam> + </methodsynopsis> <para> - <parameter>address</parameter> analyse la chaîne - <parameter>address</parameter> et essaie, pour chaque adresse, - de retourner un tableau d'objets. Les 4 objets sont : + <parameter>imap_rfc822_parse_adrlist</parameter> analyse la chaîne + <parameter>address</parameter>, tel que définie dans la + <ulink url="&url.rfc;rfc2822.html">RFC2822</ulink> et essaie, pour chaque adresse, + de retourner un tableau d'objets. Les 4 membres de ces objets sont : </para> <para> <itemizedlist> @@ -46,18 +47,22 @@ <example> <title>Exemple avec <function>imap_rfc822_parse_adrlist</function></title> <programlisting role="php"> -<?php -$address_string = "Hartmut Holzgraefe <hartmut@cvs.php.net>, postmaster@somedomain.net, root"; -$address_array = imap_rfc822_parse_adrlist($address_string,"somedomain.net"); -if(! is_array($address_array)) die("une erreur...\n"); -reset($address_array); -while(list($key,$val)=each($address_array)){ - print "boîte : ".$val->mailbox."<br>\n"; - print "hôte : ".$val->host."<br>\n"; - print "personnel: ".$val->personal."<br>\n"; - print "adl : ".$val->adl."<p>\n"; -} -?> +<![CDATA[ +<?php + $address_string = "Hartmut Holzgraefe <hartmut@cvs.php.net>, postmaster@somedomain.net, root"; + $address_array = imap_rfc822_parse_adrlist($address_string,"somedomain.net"); + if(! is_array($address_array)) die("Erreur!\n"); + + reset($address_array); + while(list($key,$val)=each($address_array)){ + print "boîte : ".$val->mailbox."<br>\n"; + print "hôte : ".$val->host."<br>\n"; + print "nom : ".$val->personal."<br>\n"; + print "adl : ".$val->adl."<p>\n"; + } +?> +]]> + </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml diff -u phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml:1.1 phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml:1.1 Sun Apr 14 20:31:01 2002 +++ phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml Wed Feb 5 22:49:01 2003 @@ -4,15 +4,15 @@ <refentry id="function.imap-rfc822-parse-headers"> <refnamediv> <refname>imap_rfc822_parse_headers</refname> - <refpurpose>Analyse une en-tête mail</refpurpose> + <refpurpose>Analyse une entête mail</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>object</type><methodname>imap_rfc822_parse_headers</methodname> - <methodparam><type>string</type><parameter>headers</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>defaulthost</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>object</type><methodname>imap_rfc822_parse_headers</methodname> + <methodparam><type>string</type><parameter>headers</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>defaulthost</parameter></methodparam> + </methodsynopsis> <para> <function>imap_rfc822_parse_headers</function> analyse la chaîne <parameter>headers</parameter>, et retourne un objet contenant Index: phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml diff -u phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml:1.1 phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml:1.1 Sun Apr 14 20:31:01 2002 +++ phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml Wed Feb 5 22:49:01 2003 @@ -4,31 +4,32 @@ <refentry id="function.imap-rfc822-write-address"> <refnamediv> <refname>imap_rfc822_write_address</refname> - <refpurpose> - Retourne une adresse email proprement formatée - </refpurpose> + <refpurpose>Retourne une adresse email formatée correctement</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>imap_rfc822_write_address</methodname> - <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> - <methodparam><type>string</type><parameter>host</parameter></methodparam> - <methodparam><type>string</type><parameter>personal</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>imap_rfc822_write_address</methodname> + <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> + <methodparam><type>string</type><parameter>host</parameter></methodparam> + <methodparam><type>string</type><parameter>personal</parameter></methodparam> + </methodsynopsis> <para> - <parameter>mailbox</parameter> retourne une adresse email proprement - formatée, à partir du nom de la boîte aux - lettres de l'hôte <parameter>host</parameter>, et - des informations personnelles <parameter>personal</parameter>. + <parameter>mailbox</parameter> retourne une adresse email formatée + correctement selon la <ulink url="&url.rfc;rfc2822.html">RFC2822</ulink>, + à partir du nom de la boîte aux lettres de l'hôte + <parameter>host</parameter>, et des informations personnelles + <parameter>personal</parameter>. </para> <para> <example> <title>Exemple avec <function>imap_rfc822_write_address</function></title> <programlisting role="php"> -<?php -print imap_rfc822_write_address("hartmut","cvs.php.net","Hartmut Holzgraefe")."\n"; -?> +<![CDATA[ +<?php + print imap_rfc822_write_address("hartmut","cvs.php.net","Hartmut Holzgraefe")."\n"; +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml diff -u phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml:1.1 phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml:1.1 Sun Apr 14 20:31:01 2002 +++ phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml Wed Feb 5 22:49:01 2003 @@ -5,25 +5,21 @@ <refnamediv> <refname>imap_scanmailbox</refname> <refpurpose> - Lit la liste des boîtes aux lettres, et y recherche une chaîne. + Lit la liste des boîtes aux lettres, et y recherche une chaîne </refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>imap_scanmailbox</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>string</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>imap_scanmailbox</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> + <methodparam><type>string</type><parameter>content</parameter></methodparam> + </methodsynopsis> <para> - <function>imap_scanmailbox</function> retourne un tableau contenant - les noms des boîtes aux lettres qui contiennent la chaîne - <parameter>string</parameter>. <function>imap_scanmailbox</function> - est simialaire à <function>imap_listmailbox</function>, - mais va aussi rechercher la chaîne <parameter>string</parameter> dans - dans les données de la boîte aux lettres. Reportez-vous à - <function>imap_getmailboxes</function> pour une description des - paramètres <parameter>ref</parameter> et <parameter>pattern</parameter>. + <function>imap_scanmailbox</function> est un &alias de + <function>imap_listscan</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/imap/functions/imap-search.xml diff -u phpdoc-fr/reference/imap/functions/imap-search.xml:1.1 phpdoc-fr/reference/imap/functions/imap-search.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-search.xml:1.1 Sun Apr 14 20:31:01 2002 +++ phpdoc-fr/reference/imap/functions/imap-search.xml Wed Feb 5 22:49:01 2003 @@ -10,12 +10,12 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>imap_search</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>criteria</parameter></methodparam> - <methodparam><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>imap_search</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>criteria</parameter></methodparam> + <methodparam><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> <para> <function>imap_search</function> effectue une recherche dans la boîte aux lettres courante, sur le flot <acronym>IMAP</acronym> courant. Index: phpdoc-fr/reference/imap/functions/imap-set-quota.xml diff -u phpdoc-fr/reference/imap/functions/imap-set-quota.xml:1.1 phpdoc-fr/reference/imap/functions/imap-set-quota.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-set-quota.xml:1.1 Sun Apr 14 20:31:01 2002 +++ phpdoc-fr/reference/imap/functions/imap-set-quota.xml Wed Feb 5 22:49:01 2003 @@ -8,12 +8,12 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_set_quota</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>quota_root</parameter></methodparam> - <methodparam><type>int</type><parameter>quota_limit</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_set_quota</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>quota_root</parameter></methodparam> + <methodparam><type>int</type><parameter>quota_limit</parameter></methodparam> + </methodsynopsis> <para> <function>imap_set_quota</function> modifie le quota de la boîte aux lettres <parameter>quota_root</parameter>, en la @@ -46,14 +46,19 @@ <example> <title>Exemple avec <function>imap_set_quota</function></title> <programlisting role="php"> -<?php -$mbox = imap_open ("{votre.hote.imap:143}", "mailadmin", "mot de passe"); -if(!imap_set_quota($mbox, "user.toto", 3000)) { - print "Erreur lors de la modification des quotas\n"; - return; +<![CDATA[ +<?php +$mbox = imap_open ("{your.imap.host:143}", "mailadmin", "password"); + +if(!imap_set_quota($mbox, "user.kalowsky", 3000)) { + print "Error in setting quota\n"; + return; } + imap_close($mbox); -?> +?> +]]> + </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-setflag-full.xml diff -u phpdoc-fr/reference/imap/functions/imap-setflag-full.xml:1.1 phpdoc-fr/reference/imap/functions/imap-setflag-full.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-setflag-full.xml:1.1 Sun Apr 14 20:31:02 2002 +++ phpdoc-fr/reference/imap/functions/imap-setflag-full.xml Wed Feb 5 22:49:01 2003 @@ -4,17 +4,17 @@ <refentry id="function.imap-setflag-full"> <refnamediv> <refname>imap_setflag_full</refname> - <refpurpose>Positionne un flag sur un message.</refpurpose> + <refpurpose>Positionne un flag sur un message</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>imap_setflag_full</methodname> - <methodparam><type>int</type><parameter>stream</parameter></methodparam> - <methodparam><type>string</type><parameter>sequence</parameter></methodparam> - <methodparam><type>string</type><parameter>flag</parameter></methodparam> - <methodparam><type>string</type><parameter>options</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_setflag_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><type>string</type><parameter>options</parameter></methodparam> + </methodsynopsis> <para> <function>imap_setflag_full</function> affecte le flag spécifié aux messages de la sequence donné. @@ -37,14 +37,19 @@ <example> <title>Exemple avec <function>imap_setflag_full</function></title> <programlisting role="php"> -<?php -$mbox = imap_open("{votre.hote.imap:143}","utilisateur","mot_de_passe") - or die("can't connect: ".imap_last_error()); +<![CDATA[ +<?php +$mbox = imap_open("{your.imap.host:143}","username","password") + or die("can't connect: ".imap_last_error()); + $status = imap_setflag_full($mbox,"2,5","\\Seen \\Flagged"); + print gettype($status)."\n"; print $status."\n"; + imap_close($mbox); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-sort.xml diff -u phpdoc-fr/reference/imap/functions/imap-sort.xml:1.1 phpdoc-fr/reference/imap/functions/imap-sort.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-sort.xml:1.1 Sun Apr 14 20:31:02 2002 +++ phpdoc-fr/reference/imap/functions/imap-sort.xml Wed Feb 5 22:49:01 2003 @@ -4,17 +4,18 @@ <refentry id="function.imap-sort"> <refnamediv> <refname>imap_sort</refname> - <refpurpose>Trie des messages.</refpurpose> + <refpurpose>Trie des messages</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>imap_sort</methodname> - <methodparam><type>int</type><parameter>stream</parameter></methodparam> - <methodparam><type>int</type><parameter>criteria</parameter></methodparam> - <methodparam><type>int</type><parameter>reverse</parameter></methodparam> - <methodparam><type>int</type><parameter>options</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>imap_sort</methodname> + <methodparam><type>resource</type><parameter>stream</parameter></methodparam> + <methodparam><type>int</type><parameter>criteria</parameter></methodparam> + <methodparam><type>int</type><parameter>reverse</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>search_criteria</parameter></methodparam> + </methodsynopsis> <para> <function>imap_sort</function> retourne un tableau de nombre de message, triés suivant les paramètres suivants : Index: phpdoc-fr/reference/imap/functions/imap-subscribe.xml diff -u phpdoc-fr/reference/imap/functions/imap-subscribe.xml:1.1 phpdoc-fr/reference/imap/functions/imap-subscribe.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-subscribe.xml:1.1 Sun Apr 14 20:31:04 2002 +++ phpdoc-fr/reference/imap/functions/imap-subscribe.xml Wed Feb 5 22:49:01 2003 @@ -4,23 +4,22 @@ <refentry id="function.imap-subscribe"> <refnamediv> <refname>imap_subscribe</refname> - <refpurpose>Souscrit à une boîte aux lettres.</refpurpose> + <refpurpose>Souscrit à une boîte aux lettres</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_subscribe</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>mbox</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_subscribe</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>mbox</parameter></methodparam> + </methodsynopsis> <para> <function>imap_subscribe</function> souscrit à la boîte aux lettres <parameter>mbox</parameter>. </para> - <para> - <function>imap_subscribe</function> retourne &true; en cas de - succès, et &false; en cas d'échec. - </para> + <para> + &return.success; + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/imap/functions/imap-undelete.xml diff -u phpdoc-fr/reference/imap/functions/imap-undelete.xml:1.1 phpdoc-fr/reference/imap/functions/imap-undelete.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-undelete.xml:1.1 Sun Apr 14 20:31:05 2002 +++ phpdoc-fr/reference/imap/functions/imap-undelete.xml Wed Feb 5 22:49:01 2003 @@ -4,26 +4,23 @@ <refentry id="function.imap-undelete"> <refnamediv> <refname>imap_undelete</refname> - <refpurpose> - Enlève la marque d'effacement d'un message. - </refpurpose> + <refpurpose>Enlève la marque d'effacement d'un message</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_undelete</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>int</type><parameter>msg_number</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_undelete</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>int</type><parameter>msg_number</parameter></methodparam> + </methodsynopsis> <para> <function>imap_undelete</function> enlève la marque d'effacement du message <parameter>msg_number</parameter>, placée avec <function>imap_delete</function>. </para> - <para> - <function>imap_subscribe</function> retourne &true; en cas - de succès, et &false; en cas d'erreur. - </para> + <para> + &return.success; + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml diff -u phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml:1.1 phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml:1.1 Sun Apr 14 20:31:05 2002 +++ phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml Wed Feb 5 22:49:01 2003 @@ -4,17 +4,15 @@ <refentry id="function.imap-unsubscribe"> <refnamediv> <refname>imap_unsubscribe</refname> - <refpurpose> - Termine la souscription à une boîte aux lettres. - </refpurpose> + <refpurpose>Termine la souscription à une boîte aux lettres</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_unsubscribe</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>mbox</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_unsubscribe</methodname> + <methodparam><type>string</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>mbox</parameter></methodparam> + </methodsynopsis> <para> <function>imap_unsubscribe</function> termine la souscription à la boîte aux lettres <parameter>mbox</parameter>.
Index: phpdoc-fr/reference/imap/reference.xml diff -u phpdoc-fr/reference/imap/reference.xml:1.3 phpdoc-fr/reference/imap/reference.xml:1.4 --- phpdoc-fr/reference/imap/reference.xml:1.3 Mon Nov 18 10:18:21 2002 +++ phpdoc-fr/reference/imap/reference.xml Wed Feb 5 22:49:00 2003 @@ -1,15 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <reference id="ref.imap"> <title>IMAP</title> <titleabbrev>IMAP</titleabbrev> - <partintro> - <simpara> - Pour avoir accès à ces fonctions, vous devez compiler PHP - avec l'option <link linkend="install.configure.with-imap"><option role="configure">--with-imap</option></link>. - Il faut avoir installé la librairie C-client. - Chargez sa dernière version sur le serveur - <ulink url="&url.imap;">&url.imap;</ulink> et compilez la. + <partintro> + <section id="imap.intro"> + &reftitle.intro; + <para> + These functions are not limited to the <acronym>IMAP</acronym> protocol, + despite their name. The underlying c-client library also supports + <acronym>NNTP</acronym>, <acronym>POP3</acronym> and local mailbox access + methods. + </para> + </section> + + <section id="imap.requirements"> + &reftitle.required; + <para> + Cette extension requiert la librairie C cliente. Téléchargez + cette dernière version à <ulink url="&url.imap;">&url.imap;</ulink> + et compilez la. + </para> + <para> Puis, copiez le fichier <filename>c-client/c-client.a</filename> dans <filename>/usr/local/lib</filename> ou n'importe quel autre dossier qui soit dans le chemin de link. Enfin, copiez les fichiers @@ -17,20 +29,69 @@ et <filename>linkage.h</filename> dans <filename>/usr/local/include</filename> ou n'importe quel autre dossier qui soit dans le chemin d'inclusion. - </simpara> - <simpara> - Ces fonctions ne sont pas limitées au protocole - <acronym>IMAP</acronym>, malgré leur nom. La librairie sur laquelle - elles sont développées supporte aussi <acronym>NNTP</acronym>, - <acronym>POP3</acronym> et les méthodes d'accès aux - boîtes aux lettres locales. Reportez-vous à la fonction - <function>imap_open</function> pour plus d'informations. - </simpara> - <para> + </para> + <note> + <para> + Assurez vous que <filename>c-client.a</filename> est bien dans votre + chemin de link, sous le nom <filename>libc-client.a</filename>. + </para> + </note> + <para> + Copiez les fichiers suivants dans le dossier + <filename>/usr/local/include</filename> ou dans n'importe quel + dossier qui soit dans votre chemin d'inclusion. + <simplelist> + <member><filename>c-client.h</filename></member> + <member><filename>imap4r1.h</filename></member> + <member><filename>rfc822.h</filename></member> + <member><filename>mail.h</filename></member> + <member><filename>linkage.h</filename></member> + <member><filename>env.h</filename></member> + <member><filename>env_unix.h</filename></member> + <member><filename>fs.h</filename></member> + <member><filename>ftl.h</filename></member> + <member><filename>misc.h</filename></member> + <member><filename>nntp.h</filename></member> + <member><filename>nl.h</filename></member> + <member><filename>osdep.h</filename></member> + <member><filename>smtp.h</filename></member> + <member><filename>tcp.h</filename></member> + </simplelist> + </para> + <note> + <para> + Le nom de <filename>env_unix.h</filename> dépend de votre OS. + Assurez vous que ces fichiers sont bien copiés avec l'option + de suivi des liens. Pour compiler la librairie C cliente avec + SSL et/ou avec le support Kerberos, lisez la doc fournie dans + la distribution. + </para> + </note> + </section> + + &reference.imap.configure; + + <section id="imap.configuration"> + &reftitle.runtime; + &no.config; + </section> + + <section id="imap.resources"> + &reftitle.resources; + <para> + </para> + </section> + + &reference.imap.constants; + + <section id="imap.seealso"> + &reftitle.seealso; + <para> Ce document ne peut entrer dans les détails de toutes les sujets abordés. Plus d'informations sont disponibles avec la documentation de la librairie C (<filename>docs/internal.txt</filename>) ainsi que les RFC suivantes : + documents: <itemizedlist> <listitem> <simpara> @@ -84,8 +145,17 @@ <ulink url="&url.email.book;">Programming Internet Email</ulink> par David Wood et <ulink url="&url.imap.book;">Managing IMAP</ulink> par Dianna Mullet & Kevin Mullet. - </para> - </partintro> + </para> + <warning> + <para> + Des crashs et des problèmes de démarrage de &php; sont possibles lorsque + vous chargez cette extension en même temps que l'extension recode. + Voyez l'extension <link linkend="ref.recode">recode</link> pour plus + d'informations. + </para> + </warning> + </section> + </partintro> &reference.imap.functions; Index: phpdoc-fr/reference/imap/functions/imap-8bit.xml diff -u phpdoc-fr/reference/imap/functions/imap-8bit.xml:1.1 phpdoc-fr/reference/imap/functions/imap-8bit.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-8bit.xml:1.1 Sun Apr 14 20:30:53 2002 +++ phpdoc-fr/reference/imap/functions/imap-8bit.xml Wed Feb 5 22:49:01 2003 @@ -17,7 +17,8 @@ </methodsynopsis> <para> <function>imap_8bit</function> convertit la chaîne à 8 bits - en une chaîne à guillemets. + en une chaîne à guillemets + (selon la <ulink url="&url.rfc;rfc2045.html">RFC 2045</ulink>, Section 6.7). </para> <para> <function>imap_8bit</function> retourne une chaîne à Index: phpdoc-fr/reference/imap/functions/imap-append.xml diff -u phpdoc-fr/reference/imap/functions/imap-append.xml:1.1 phpdoc-fr/reference/imap/functions/imap-append.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-append.xml:1.1 Sun Apr 14 20:30:53 2002 +++ phpdoc-fr/reference/imap/functions/imap-append.xml Wed Feb 5 22:49:01 2003 @@ -10,13 +10,13 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</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><type>string</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <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'option @@ -25,8 +25,7 @@ aux lettres. </para> <para> - <function>imap_append</function> retourne &true; - en cas de succès, et &false; en cas d'erreur. + &return.sucess; </para> <para> Lors des échanges avec le serveur Cyrus IMAP, vous devrez utiliser @@ -37,13 +36,14 @@ <example> <title>Exemple avec <function>imap_append</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $stream = imap_open("{your.imap.host}INBOX.Drafts","username", "password"); $check = imap_check($stream); print "Nombre de message avant ajout : ". $check->Nmsgs."\n"; imap_append($stream,"{your.imap.host}INBOX.Drafts" - ,"From: me@my.host\r\n" - ."To: you@your.host\r\n" + ,"From: moi@mon.hote\r\n" + ."To: toi@ton.hote\r\n" ."Subject: test\r\n" ."\r\n" ."Ceci est un message de test. Ignorez le\r\n" @@ -51,7 +51,8 @@ $check = imap_check($stream); print "Nombre de message après ajout : ". $check->Nmsgs."\n"; imap_close($stream); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-base64.xml diff -u phpdoc-fr/reference/imap/functions/imap-base64.xml:1.1 phpdoc-fr/reference/imap/functions/imap-base64.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-base64.xml:1.1 Sun Apr 14 20:30:53 2002 +++ phpdoc-fr/reference/imap/functions/imap-base64.xml Wed Feb 5 22:49:01 2003 @@ -4,7 +4,7 @@ <refentry id="function.imap-base64"> <refnamediv> <refname>imap_base64</refname> - <refpurpose>Décode un texte encodé en BASE64.</refpurpose> + <refpurpose>Décode un texte encodé en BASE64</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -15,7 +15,8 @@ <para> <function>imap_base64</function> décode un texte encodé en BASE64. Le texte décodé est retourné sous la - forme d'une chaîne. + forme d'une chaîne + (selon la <ulink url="&url.rfc;rfc2045.html">RFC 2045</ulink>, Section 6.8). </para> </refsect1> </refentry> Index: phpdoc-fr/reference/imap/functions/imap-binary.xml diff -u phpdoc-fr/reference/imap/functions/imap-binary.xml:1.1 phpdoc-fr/reference/imap/functions/imap-binary.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-binary.xml:1.1 Sun Apr 14 20:30:53 2002 +++ phpdoc-fr/reference/imap/functions/imap-binary.xml Wed Feb 5 22:49:01 2003 @@ -17,7 +17,8 @@ </methodsynopsis> <para> <function>imap_binary</function> convertit la chaîne à - 8 bits <parameter>string</parameter> en une chaîne à base64. + 8 bits <parameter>string</parameter> en une chaîne à base64 + (selon la <ulink url="&url.rfc;rfc2045.html">RFC 2045</ulink>, Section 6.8). </para> <para> <function>imap_binary</function> retourne la chaîne codée. Index: phpdoc-fr/reference/imap/functions/imap-body.xml diff -u phpdoc-fr/reference/imap/functions/imap-body.xml:1.1 phpdoc-fr/reference/imap/functions/imap-body.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-body.xml:1.1 Sun Apr 14 20:30:54 2002 +++ phpdoc-fr/reference/imap/functions/imap-body.xml Wed Feb 5 22:49:01 2003 @@ -4,16 +4,16 @@ <refentry id="function.imap-body"> <refnamediv> <refname>imap_body</refname> - <refpurpose>Lit le corps d'un message.</refpurpose> + <refpurpose>Lit le corps d'un message</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <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><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <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. Index: phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml diff -u phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml:1.1 phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml:1.1 Sun Apr 14 20:30:54 2002 +++ phpdoc-fr/reference/imap/functions/imap-clearflag-full.xml Wed Feb 5 22:49:01 2003 @@ -4,21 +4,24 @@ <refentry id="function.imap-clearflag-full"> <refnamediv> <refname>imap_clearflag_full</refname> - <refpurpose>Supprime un flag sur un message.</refpurpose> + <refpurpose>Supprime un flag sur un message</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>string</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><type>string</type><parameter>options</parameter></methodparam> - </methodsynopsis> + <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><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 flot imap <parameter>stream</parameter>. + Les flags <parameter>flag</parameter> que vous pouvez effacer sont + "\\Seen", "\\Answered", "\\Flagged", "\\Deleted" et "\\Draft" (tels + que dfinis dans la RFC2060). </para> <para> Les options sont un masque de bit, qui accepte les valeurs suivantes : Index: phpdoc-fr/reference/imap/functions/imap-close.xml diff -u phpdoc-fr/reference/imap/functions/imap-close.xml:1.1 phpdoc-fr/reference/imap/functions/imap-close.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-close.xml:1.1 Sun Apr 14 20:30:54 2002 +++ phpdoc-fr/reference/imap/functions/imap-close.xml Wed Feb 5 22:49:01 2003 @@ -4,15 +4,15 @@ <refentry id="function.imap-close"> <refnamediv> <refname>imap_close</refname> - <refpurpose>Termine un flot IMAP.</refpurpose> + <refpurpose>Termine un flot IMAP</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_close</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <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 flot <acronym>IMAP</acronym>. <function>imap_close</function> prend un argument optionnel Index: phpdoc-fr/reference/imap/functions/imap-createmailbox.xml diff -u phpdoc-fr/reference/imap/functions/imap-createmailbox.xml:1.1 phpdoc-fr/reference/imap/functions/imap-createmailbox.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-createmailbox.xml:1.1 Sun Apr 14 20:30:54 2002 +++ phpdoc-fr/reference/imap/functions/imap-createmailbox.xml Wed Feb 5 22:49:01 2003 @@ -4,15 +4,15 @@ <refentry id="function.imap-createmailbox"> <refnamediv> <refname>imap_createmailbox</refname> - <refpurpose>Crée une nouvelle boîte aux lettres.</refpurpose> + <refpurpose>Crée une nouvelle boîte aux lettres</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_createmailbox</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>mbox</parameter></methodparam> - </methodsynopsis> + <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 @@ -27,44 +27,46 @@ <example> <title>Exemple avec <function>imap_createmailbox</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open("{your.imap.host}","utilisateur","mot_de_passe",OP_HALFOPEN) or die("connexion impossible: ".imap_last_error()); $name1 = "nouvellephpbox"; $name2 = imap_utf7_encode("nouvellephpboxéx"); $newname = $name1; -echo "Le nouveau nom sera '$name1'<br>\n"; -# 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. +echo "Le nouveau nom sera '$name1'<BR>\n"; +// 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("{your.imap.host}INBOX.$newname"))){ $status = @imap_status($mbox,"{your.imap.host}INBOX.$newname",SA_ALL); if($status) { - print("Votre nouvelle boîte '$name1' est dans l'état suivant :<br>\n"); - print("Messages: ". $status->messages )."<br>\n"; - print("Récent: ". $status->recent )."<br>\n"; - print("Non lus: ". $status->unseen )."<br>\n"; - print("UID suivant: ". $status->uidnext )."<br>\n"; - print("UID validité:". $status->uidvalidity)."<br>\n"; + print("Votre nouvelle boîte '$name1' est dans l'état suivant :<BR>\n"); + print("Messages: ". $status->messages )."<BR>\n"; + print("Récent: ". $status->recent )."<BR>\n"; + print("Non lus: ". $status->unseen )."<BR>\n"; + print("UID suivant: ". $status->uidnext )."<BR>\n"; + print("UID validité:". $status->uidvalidity)."<BR>\n"; if(imap_renamemailbox($mbox,"{your.imap.host}INBOX.$newname","{your.imap.host}INBOX.$name2")) { - echo "renommage de la boîte aux lettres '$name1' en '$name2'<br>\n"; + echo "renommage de la boîte aux lettres '$name1' en '$name2'<BR>\n"; $newname=$name2; } else { - print "imap_renamemailbox sur la nouvelle boîte aux lettres a échoué : ".imap_last_error()."<br>\n"; + print "imap_renamemailbox sur la nouvelle boîte aux lettres a échoué : ".imap_last_error()."<BR>\n"; } } else { - print "imap_status sur la nouvelle boîte aux lettres a échoué : ".imap_last_error()."<br>\n"; + print "imap_status sur la nouvelle boîte aux lettres a échoué : ".imap_last_error()."<BR>\n"; } if(@imap_deletemailbox($mbox,"{your.imap.host}INBOX.$newname")) { - print "new mailbox supprimée pour remettre tout en état<br>\n"; + print "new mailbox supprimée pour remettre tout en état<BR>\n"; } else { - print "imap_deletemailbox ur la nouvelle boîte aux lettres a échoué : ".implode("<br>\n",imap_errors())."<br>\n"; + print "imap_deletemailbox ur la nouvelle boîte aux lettres a échoué : ".implode("<BR>\n",imap_errors())."<BR>\n"; } } else { - print "Impossible de créer une nouvelle boîte aux lettres : ".implode("<br>\n",imap_errors())."<br>\n"; + print "Impossible de créer une nouvelle boîte aux lettres : ".implode("<BR>\n",imap_errors())."<BR>\n"; } imap_close($mbox); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-delete.xml diff -u phpdoc-fr/reference/imap/functions/imap-delete.xml:1.1 phpdoc-fr/reference/imap/functions/imap-delete.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-delete.xml:1.1 Sun Apr 14 20:30:54 2002 +++ phpdoc-fr/reference/imap/functions/imap-delete.xml Wed Feb 5 22:49:01 2003 @@ -5,20 +5,17 @@ <refnamediv> <refname>imap_delete</refname> <refpurpose> - Marque le fichier pour l'effacement, dans la boîte aux lettres courante. + Marque le fichier pour l'effacement, dans la boîte aux lettres courante </refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_delete</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>flags</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_delete</function> retourne &true;. - </para> + <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> marque le fichier <parameter>msg_number</parameter> pour l'effacement, dans la @@ -30,22 +27,27 @@ <function>imap_expunge</function>. </para> <para> + <function>imap_delete</function> retourne &true;. + </para> + <para> <example> - <title>Exemple <function>imap_delete</function></title> + <title>Exemple avec <function>imap_delete</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open ("{your.imap.host}INBOX", "utilisateur", "mot_de_passe") or die ("connexion impossible: " . imap_last_error()); $check = imap_mailboxmsginfo ($mbox); -print "Nombre de messages avant effacement : " . $check->Nmsgs . "<br>\n" ; +print "Nombre de messages avant effacement : " . $check->Nmsgs . "<BR>\n" ; imap_delete ($mbox, 1); $check = imap_mailboxmsginfo ($mbox); -print "Nombre de messages après effacement: " . $check->Nmsgs . "<br>\n" ; +print "Nombre de messages après effacement: " . $check->Nmsgs . "<BR>\n" ; imap_expunge ($mbox); $check = imap_mailboxmsginfo ($mbox); -print "Nombre de messages après imap_expunge: " . $check->Nmsgs . "<br>\n" ; +print "Nombre de messages après imap_expunge: " . $check->Nmsgs . "<BR>\n" ; imap_close ($mbox); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml diff -u phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml:1.1 phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml:1.1 Sun Apr 14 20:30:55 2002 +++ phpdoc-fr/reference/imap/functions/imap-deletemailbox.xml Wed Feb 5 22:49:01 2003 @@ -4,15 +4,15 @@ <refentry id="function.imap-deletemailbox"> <refnamediv> <refname>imap_deletemailbox</refname> - <refpurpose>Efface une boîte aux lettres.</refpurpose> + <refpurpose>Efface une boîte aux lettres</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_deletemailbox</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>mbox</parameter></methodparam> - </methodsynopsis> + <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 (voir <function>imap_open</function> pour connaître le format Index: phpdoc-fr/reference/imap/functions/imap-expunge.xml diff -u phpdoc-fr/reference/imap/functions/imap-expunge.xml:1.1 phpdoc-fr/reference/imap/functions/imap-expunge.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-expunge.xml:1.1 Sun Apr 14 20:30:55 2002 +++ phpdoc-fr/reference/imap/functions/imap-expunge.xml Wed Feb 5 22:49:01 2003 @@ -10,10 +10,10 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_expunge</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - </methodsynopsis> + <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>. Index: phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml diff -u phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml:1.1 phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml:1.1 Sun Apr 14 20:30:55 2002 +++ phpdoc-fr/reference/imap/functions/imap-fetch-overview.xml Wed Feb 5 22:49:01 2003 @@ -10,12 +10,12 @@ </refnamediv> <refsect1> <title>Description</title> - <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>flags</parameter></methodparam> - </methodsynopsis> + <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 @@ -100,21 +100,26 @@ <example> <title>Exemple avec <function>imap_fetch_overview</function></title> <programlisting role="php"> -<?php -$mbox = imap_open("{votre.hote.imap}","utilisateur","mot_de_passe") +<![CDATA[ +<?php +$mbox = imap_open("{your.imap.host:143}","username","password") or die("connexion impossible : ".imap_last_error()); + $overview = imap_fetch_overview($mbox,"2,4:6",0); + if(is_array($overview)) { - reset($overview); - while( list($key,$val) = each($overview)) { - print $val->msgno - . " - " . $val->date - . " - " . $val->subject - . "\n"; - } + reset($overview); + while( list($key,$val) = each($overview)) { + print $val->msgno + . " - " . $val->date + . " - " . $val->subject + . "\n"; + } } + imap_close($mbox); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-fetchbody.xml diff -u phpdoc-fr/reference/imap/functions/imap-fetchbody.xml:1.1 phpdoc-fr/reference/imap/functions/imap-fetchbody.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-fetchbody.xml:1.1 Sun Apr 14 20:30:56 2002 +++ phpdoc-fr/reference/imap/functions/imap-fetchbody.xml Wed Feb 5 22:49:01 2003 @@ -4,17 +4,17 @@ <refentry id="function.imap-fetchbody"> <refnamediv> <refname>imap_fetchbody</refname> - <refpurpose>Retourne une section extraite du corps d'un message.</refpurpose> + <refpurpose>Retourne une section extraite du corps d'un message</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <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>flags</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <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>flags</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 @@ -46,6 +46,10 @@ </listitem> </itemizedlist> </para> + <para> + Voir aussi + <function>imap_fetchstructure</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/imap/functions/imap-fetchheader.xml diff -u phpdoc-fr/reference/imap/functions/imap-fetchheader.xml:1.1 phpdoc-fr/reference/imap/functions/imap-fetchheader.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-fetchheader.xml:1.1 Sun Apr 14 20:30:56 2002 +++ phpdoc-fr/reference/imap/functions/imap-fetchheader.xml Wed Feb 5 22:49:01 2003 @@ -4,19 +4,20 @@ <refentry id="function.imap-fetchheader"> <refnamediv> <refname>imap_fetchheader</refname> - <refpurpose>Retourne l'en-tête d'un message.</refpurpose> + <refpurpose>Retourne l'en-tête d'un message</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <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><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <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><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> <para> <function>imap_fetchheader</function> retourne l'en-tête brute et - complète RFC 822 du message <parameter>msgno</parameter>, et le retourne + complète <ulink url="&url.rfc;rfc2822.html">RFC2822</ulink> + du message <parameter>msgno</parameter>, et le retourne sous la forme d'une chaîne. </para> <para> Index: phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml diff -u phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml:1.1 phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml:1.1 Sun Apr 14 20:30:56 2002 +++ phpdoc-fr/reference/imap/functions/imap-fetchstructure.xml Wed Feb 5 22:49:01 2003 @@ -10,12 +10,12 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>object</type><methodname>imap_fetchstructure</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>flags</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>object</type><methodname>imap_fetchstructure</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_fetchstructure</function> la structure du message <parameter>msg_number</parameter>. <function>imap_fetchstructure</function> Index: phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml diff -u phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml:1.1 phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml:1.1 Sun Apr 14 20:30:56 2002 +++ phpdoc-fr/reference/imap/functions/imap-getmailboxes.xml Wed Feb 5 22:49:01 2003 @@ -10,12 +10,12 @@ </refnamediv> <refsect1> <title>Description</title> - <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>pat</parameter></methodparam> - </methodsynopsis> + <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 a les attributs @@ -73,23 +73,25 @@ <example> <title>Exemple avec <function>imap_getmailboxes</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open("{your.imap.host}","utilisateur","mot_de_passe",OP_HALFOPEN) - or die("connexion impossible: ".imap_last_error()); -$list = imap_getmailboxes($mbox,"{your.imap.host}","*"); + or die("connexion impossible : ".imap_last_error()); +$list = imap_getmailboxes($mbox,"{votre.hote.imap}","*"); if(is_array($list)) { - reset($list); - while (list($key, $val) = each($list)) - { + reset($list); + while (list($key, $val) = each($list)) { print "($key) "; print imap_utf7_decode($val->name).","; print "'".$val->delimiter."',"; - print $val->attributes."<br>\n"; - } -} else - print "imap_getmailboxes a échoué : ".imap_last_error()."\n"; + print $val->attributes."<BR>\n"; + } +} else { + print "imap_getmailboxes a échoué : ".imap_last_error()."\n"; +} imap_close($mbox); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml diff -u phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml:1.1 phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml:1.1 Sun Apr 14 20:30:57 2002 +++ phpdoc-fr/reference/imap/functions/imap-getsubscribed.xml Wed Feb 5 22:49:01 2003 @@ -4,16 +4,16 @@ <refentry id="function.imap-getsubscribed"> <refnamediv> <refname>imap_getsubscribed</refname> - <refpurpose>Liste toutes les boîtes aux lettres souscrites.</refpurpose> + <refpurpose>Liste toutes les boîtes aux lettres souscrites</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <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> + <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 Index: phpdoc-fr/reference/imap/functions/imap-header.xml diff -u phpdoc-fr/reference/imap/functions/imap-header.xml:1.1 phpdoc-fr/reference/imap/functions/imap-header.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-header.xml:1.1 Sun Apr 14 20:30:57 2002 +++ phpdoc-fr/reference/imap/functions/imap-header.xml Wed Feb 5 22:49:01 2003 @@ -4,7 +4,7 @@ <refentry id="function.imap-header"> <refnamediv> <refname>imap_header</refname> - <refpurpose>Lit l'en-tête d'un message.</refpurpose> + <refpurpose>Lit l'en-tête d'un message</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/imap/functions/imap-listmailbox.xml diff -u phpdoc-fr/reference/imap/functions/imap-listmailbox.xml:1.1 phpdoc-fr/reference/imap/functions/imap-listmailbox.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-listmailbox.xml:1.1 Sun Apr 14 20:30:58 2002 +++ phpdoc-fr/reference/imap/functions/imap-listmailbox.xml Wed Feb 5 22:49:01 2003 @@ -4,16 +4,16 @@ <refentry id="function.imap-listmailbox"> <refnamediv> <refname>imap_listmailbox</refname> - <refpurpose>Liste les boîtes aux lettres.</refpurpose> + <refpurpose>Liste les boîtes aux lettres</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>imap_listmailbox</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>ref</parameter></methodparam> - <methodparam><type>string</type><parameter>pat</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>imap_listmailbox</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_listmailbox</function> retourne un tableau contenant les noms des boîtes aux lettres. @@ -22,7 +22,8 @@ <example> <title>Exemple avec <function>imap_listmailbox</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open("{your.imap.host}","utilisateur","mot_de_passe",OP_HALFOPEN) or die("connexion impossible: ".imap_last_error()); $list = imap_listmailbox($mbox,"{your.imap.host}","*"); @@ -33,7 +34,8 @@ } else print "imap_listmailbox a échoué: ".imap_last_error()."\n"; imap_close($mbox); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-listsubscribed.xml diff -u phpdoc-fr/reference/imap/functions/imap-listsubscribed.xml:1.1 phpdoc-fr/reference/imap/functions/imap-listsubscribed.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-listsubscribed.xml:1.1 Sun Apr 14 20:30:58 2002 +++ phpdoc-fr/reference/imap/functions/imap-listsubscribed.xml Wed Feb 5 22:49:01 2003 @@ -4,7 +4,7 @@ <refentry id="function.imap-listsubscribed"> <refnamediv> <refname>imap_listsubscribed</refname> - <refpurpose>Liste les boîtes aux lettres souscrites.</refpurpose> + <refpurpose>Liste les boîtes aux lettres souscrites</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/imap/functions/imap-mail-copy.xml diff -u phpdoc-fr/reference/imap/functions/imap-mail-copy.xml:1.1 phpdoc-fr/reference/imap/functions/imap-mail-copy.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-mail-copy.xml:1.1 Sun Apr 14 20:30:58 2002 +++ phpdoc-fr/reference/imap/functions/imap-mail-copy.xml Wed Feb 5 22:49:01 2003 @@ -10,19 +10,20 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_mail_copy</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>msglist</parameter></methodparam> - <methodparam><type>string</type><parameter>mbox</parameter></methodparam> - <methodparam><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_mail_copy</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>msglist</parameter></methodparam> + <methodparam><type>string</type><parameter>mbox</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> <para> <function>imap_mail_copy</function> copie les messages email spécifiés par <parameter>msglist</parameter> dans la boîte aux lettres nommée <parameter>mbox</parameter>. <parameter>msglist</parameter> est un intervalle, et pas seulement - une liste numéros de message. + une liste numéros de message (comme décrit dans la + <ulink url="&url.rfc;rfc2060.html">RFC2060</ulink>). </para> <para> <function>imap_mail_copy</function> retourne &true; Index: phpdoc-fr/reference/imap/functions/imap-mail-move.xml diff -u phpdoc-fr/reference/imap/functions/imap-mail-move.xml:1.1 phpdoc-fr/reference/imap/functions/imap-mail-move.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-mail-move.xml:1.1 Sun Apr 14 20:30:58 2002 +++ phpdoc-fr/reference/imap/functions/imap-mail-move.xml Wed Feb 5 22:49:01 2003 @@ -5,26 +5,29 @@ <refnamediv> <refname>imap_mail_move</refname> <refpurpose> - Déplace les messages spécifiés - dans une boîte aux lettres. + Déplace des messages dans une boîte aux lettres </refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_mail_move</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>msglist</parameter></methodparam> - <methodparam><type>string</type><parameter>mbox</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_mail_move</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>msglist</parameter></methodparam> + <methodparam><type>string</type><parameter>mbox</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> <para> <function>imap_mail_move</function> déplace les messages spécifiés par <parameter>msglist</parameter> dans la boîte aux lettres <parameter>mbox</parameter>. <parameter>msglist</parameter> est un intervalle, et pas seulement une - liste de messages. + liste de messages (comme décrit dans la + <ulink url="&url.rfc;rfc2060.html">RFC2060</ulink>). </para> + <para> + &return.success; + </para> <para> <parameter>flags</parameter> est un champs de bit et peut contenir une seule valeur : @@ -35,10 +38,6 @@ </simpara> </listitem> </itemizedlist> - </para> - <para> - <function>imap_mail_move</function> retourne &true; - en cas de succès, et &false; en cas d'erreur. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/imap/functions/imap-open.xml diff -u phpdoc-fr/reference/imap/functions/imap-open.xml:1.1 phpdoc-fr/reference/imap/functions/imap-open.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-open.xml:1.1 Sun Apr 14 20:30:59 2002 +++ phpdoc-fr/reference/imap/functions/imap-open.xml Wed Feb 5 22:49:01 2003 @@ -4,17 +4,17 @@ <refentry id="function.imap-open"> <refnamediv> <refname>imap_open</refname> - <refpurpose>Ouvre un flot IMAP vers une boîte aux lettres.</refpurpose> + <refpurpose>Ouvre un flot IMAP vers une boîte aux lettres</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_open</methodname> - <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> - <methodparam><type>string</type><parameter>username</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>resource</type><methodname>imap_open</methodname> + <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> + <methodparam><type>string</type><parameter>username</parameter></methodparam> + <methodparam><type>string</type><parameter>password</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> <para> <function>imap_open</function> retourne un flot <acronym>IMAP</acronym> en cas de succès, et &false; en cas d'erreur. @@ -66,45 +66,55 @@ commande suivante : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open("{localhost:143}INBOX","user_id","password"); -?> +?> +]]> </programlisting> </informalexample> Pour se connecter à un serveur <acronym>POP3</acronym> qui fonctionne sur le port 110 de la machine locale on peut utiliser la commande suivante : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open("{localhost:110/pop3}INBOX","user_id","password"); -?> +?> +]]> </programlisting> </informalexample> Pour se connecter à un serveur IMAP SSL ou POP3 SSL, ajoutez <literal>/ssl</literal> après le protocole : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open ("{localhost:993/imap/ssl}INBOX", "user_id", "password"); -?> +?> +]]> </programlisting> </informalexample> Pour se connecter à un serveur SSL IMAP ou POP3 avec un certificat ajoutez <literal>/ssl/novalidate-cert</literal> après le protocole : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open ("{localhost:995/pop3/ssl/novalidate-cert}", "user_id", "password"); -?> +?> +]]> </programlisting> </informalexample> Pour se connecter à un serveur <acronym>NNTP</acronym> qui fonctionne sur le port 119 de la machine locale on peut utiliser la commande: <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $nntp = imap_open("{localhost:119/nntp}comp.test","",""); -?> +?> +]]> </programlisting> </informalexample> Pour se connecter à un serveur distant, remplacez "localhost" par @@ -114,7 +124,8 @@ <example> <title>Exemple avec <function>imap_open</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $mbox = imap_open ("{votre.hote.imap:143}", "nom_utilisateur", "mot de passe"); echo "<p><h1>Mailboxes</h1>\n"; $folders = imap_listmailbox ($mbox, "{votre.hote.imap:143}", "*"); @@ -135,7 +146,8 @@ } } imap_close($mbox); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-ping.xml diff -u phpdoc-fr/reference/imap/functions/imap-ping.xml:1.1 phpdoc-fr/reference/imap/functions/imap-ping.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-ping.xml:1.1 Sun Apr 14 20:31:00 2002 +++ phpdoc-fr/reference/imap/functions/imap-ping.xml Wed Feb 5 22:49:01 2003 @@ -4,17 +4,17 @@ <refentry id="function.imap-ping"> <refnamediv> <refname>imap_ping</refname> - <refpurpose>Vérifie que le flot IMAP est toujours actif.</refpurpose> + <refpurpose>Vérifie que le flot IMAP est toujours actif</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_ping</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_ping</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + </methodsynopsis> <para> <function>imap_ping</function> retourne &true; si - le flot <parameter>imap_stream</parameter> existe toujours, + le flt <parameter>imap_stream</parameter> existe toujours, et &false; sinon. </para> <para> Index: phpdoc-fr/reference/imap/functions/imap-qprint.xml diff -u phpdoc-fr/reference/imap/functions/imap-qprint.xml:1.1 phpdoc-fr/reference/imap/functions/imap-qprint.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-qprint.xml:1.1 Sun Apr 14 20:31:00 2002 +++ phpdoc-fr/reference/imap/functions/imap-qprint.xml Wed Feb 5 22:49:01 2003 @@ -18,7 +18,8 @@ <para> <function>imap_qprint</function> convertit la chaîne à guillemets <parameter>string</parameter> en une chaîne à - 8 bits. + 8 bits (selon la <ulink url="&url.rfc;rfc2045.html">RFC2045</ulink>, section + 6.7). </para> <para> <function>imap_qprint</function> retourne une chaîne 8 bits (binaire). Index: phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml diff -u phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml:1.1 phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml:1.1 Sun Apr 14 20:31:00 2002 +++ phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml Wed Feb 5 22:49:01 2003 @@ -4,23 +4,22 @@ <refentry id="function.imap-renamemailbox"> <refnamediv> <refname>imap_renamemailbox</refname> - <refpurpose>Renomme une boîte aux lettres.</refpurpose> + <refpurpose>Renomme une boîte aux lettres</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_renamemailbox</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>old_mbox</parameter></methodparam> - <methodparam><type>string</type><parameter>new_mbox</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_renamemailbox</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>old_mbox</parameter></methodparam> + <methodparam><type>string</type><parameter>new_mbox</parameter></methodparam> + </methodsynopsis> <para> <function>imap_renamemailbox</function> renomme la boîte aux lettres <parameter>old_mbox</parameter> en <parameter>new_mbox</parameter>. </para> <para> - <function>imap_renamemailbox</function> retourne &true; - en cas de succès, et &false; en cas d'erreur. + &return.success; </para> <para> Voir aussi Index: phpdoc-fr/reference/imap/functions/imap-reopen.xml diff -u phpdoc-fr/reference/imap/functions/imap-reopen.xml:1.1 phpdoc-fr/reference/imap/functions/imap-reopen.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-reopen.xml:1.1 Sun Apr 14 20:31:00 2002 +++ phpdoc-fr/reference/imap/functions/imap-reopen.xml Wed Feb 5 22:49:01 2003 @@ -10,12 +10,12 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_reopen</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_reopen</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>options</parameter></methodparam> + </methodsynopsis> <para> <function>imap_reopen</function> réouvre la connexion spécifiée au serveur <acronym>IMAP</acronym> ou <acronym>NNTP</acronym>, @@ -49,6 +49,9 @@ </listitem> </itemizedlist> </para> + <para> + &return.success; + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml diff -u phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml:1.1 phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml:1.1 Sun Apr 14 20:31:01 2002 +++ phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml Wed Feb 5 22:49:01 2003 @@ -4,19 +4,20 @@ <refentry id="function.imap-rfc822-parse-adrlist"> <refnamediv> <refname>imap_rfc822_parse_adrlist</refname> - <refpurpose>Analyse une chaîne d'adresse.</refpurpose> + <refpurpose>Analyse une adresse email</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>imap_rfc822_parse_adrlist</methodname> - <methodparam><type>string</type><parameter>address</parameter></methodparam> - <methodparam><type>string</type><parameter>default_host</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>imap_rfc822_parse_adrlist</methodname> + <methodparam><type>string</type><parameter>address</parameter></methodparam> + <methodparam><type>string</type><parameter>default_host</parameter></methodparam> + </methodsynopsis> <para> - <parameter>address</parameter> analyse la chaîne - <parameter>address</parameter> et essaie, pour chaque adresse, - de retourner un tableau d'objets. Les 4 objets sont : + <parameter>imap_rfc822_parse_adrlist</parameter> analyse la chaîne + <parameter>address</parameter>, tel que définie dans la + <ulink url="&url.rfc;rfc2822.html">RFC2822</ulink> et essaie, pour chaque adresse, + de retourner un tableau d'objets. Les 4 membres de ces objets sont : </para> <para> <itemizedlist> @@ -46,18 +47,22 @@ <example> <title>Exemple avec <function>imap_rfc822_parse_adrlist</function></title> <programlisting role="php"> -<?php -$address_string = "Hartmut Holzgraefe <hartmut@cvs.php.net>, postmaster@somedomain.net, root"; -$address_array = imap_rfc822_parse_adrlist($address_string,"somedomain.net"); -if(! is_array($address_array)) die("une erreur...\n"); -reset($address_array); -while(list($key,$val)=each($address_array)){ - print "boîte : ".$val->mailbox."<br>\n"; - print "hôte : ".$val->host."<br>\n"; - print "personnel: ".$val->personal."<br>\n"; - print "adl : ".$val->adl."<p>\n"; -} -?> +<![CDATA[ +<?php + $address_string = "Hartmut Holzgraefe <hartmut@cvs.php.net>, postmaster@somedomain.net, root"; + $address_array = imap_rfc822_parse_adrlist($address_string,"somedomain.net"); + if(! is_array($address_array)) die("Erreur!\n"); + + reset($address_array); + while(list($key,$val)=each($address_array)){ + print "boîte : ".$val->mailbox."<br>\n"; + print "hôte : ".$val->host."<br>\n"; + print "nom : ".$val->personal."<br>\n"; + print "adl : ".$val->adl."<p>\n"; + } +?> +]]> + </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml diff -u phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml:1.1 phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml:1.1 Sun Apr 14 20:31:01 2002 +++ phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml Wed Feb 5 22:49:01 2003 @@ -4,15 +4,15 @@ <refentry id="function.imap-rfc822-parse-headers"> <refnamediv> <refname>imap_rfc822_parse_headers</refname> - <refpurpose>Analyse une en-tête mail</refpurpose> + <refpurpose>Analyse une entête mail</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>object</type><methodname>imap_rfc822_parse_headers</methodname> - <methodparam><type>string</type><parameter>headers</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>defaulthost</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>object</type><methodname>imap_rfc822_parse_headers</methodname> + <methodparam><type>string</type><parameter>headers</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>defaulthost</parameter></methodparam> + </methodsynopsis> <para> <function>imap_rfc822_parse_headers</function> analyse la chaîne <parameter>headers</parameter>, et retourne un objet contenant Index: phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml diff -u phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml:1.1 phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml:1.1 Sun Apr 14 20:31:01 2002 +++ phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml Wed Feb 5 22:49:01 2003 @@ -4,31 +4,32 @@ <refentry id="function.imap-rfc822-write-address"> <refnamediv> <refname>imap_rfc822_write_address</refname> - <refpurpose> - Retourne une adresse email proprement formatée - </refpurpose> + <refpurpose>Retourne une adresse email formatée correctement</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>imap_rfc822_write_address</methodname> - <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> - <methodparam><type>string</type><parameter>host</parameter></methodparam> - <methodparam><type>string</type><parameter>personal</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>imap_rfc822_write_address</methodname> + <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> + <methodparam><type>string</type><parameter>host</parameter></methodparam> + <methodparam><type>string</type><parameter>personal</parameter></methodparam> + </methodsynopsis> <para> - <parameter>mailbox</parameter> retourne une adresse email proprement - formatée, à partir du nom de la boîte aux - lettres de l'hôte <parameter>host</parameter>, et - des informations personnelles <parameter>personal</parameter>. + <parameter>mailbox</parameter> retourne une adresse email formatée + correctement selon la <ulink url="&url.rfc;rfc2822.html">RFC2822</ulink>, + à partir du nom de la boîte aux lettres de l'hôte + <parameter>host</parameter>, et des informations personnelles + <parameter>personal</parameter>. </para> <para> <example> <title>Exemple avec <function>imap_rfc822_write_address</function></title> <programlisting role="php"> -<?php -print imap_rfc822_write_address("hartmut","cvs.php.net","Hartmut Holzgraefe")."\n"; -?> +<![CDATA[ +<?php + print imap_rfc822_write_address("hartmut","cvs.php.net","Hartmut Holzgraefe")."\n"; +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml diff -u phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml:1.1 phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml:1.1 Sun Apr 14 20:31:01 2002 +++ phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml Wed Feb 5 22:49:01 2003 @@ -5,25 +5,21 @@ <refnamediv> <refname>imap_scanmailbox</refname> <refpurpose> - Lit la liste des boîtes aux lettres, et y recherche une chaîne. + Lit la liste des boîtes aux lettres, et y recherche une chaîne </refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>imap_scanmailbox</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>string</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>imap_scanmailbox</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> + <methodparam><type>string</type><parameter>content</parameter></methodparam> + </methodsynopsis> <para> - <function>imap_scanmailbox</function> retourne un tableau contenant - les noms des boîtes aux lettres qui contiennent la chaîne - <parameter>string</parameter>. <function>imap_scanmailbox</function> - est simialaire à <function>imap_listmailbox</function>, - mais va aussi rechercher la chaîne <parameter>string</parameter> dans - dans les données de la boîte aux lettres. Reportez-vous à - <function>imap_getmailboxes</function> pour une description des - paramètres <parameter>ref</parameter> et <parameter>pattern</parameter>. + <function>imap_scanmailbox</function> est un &alias de + <function>imap_listscan</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/imap/functions/imap-search.xml diff -u phpdoc-fr/reference/imap/functions/imap-search.xml:1.1 phpdoc-fr/reference/imap/functions/imap-search.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-search.xml:1.1 Sun Apr 14 20:31:01 2002 +++ phpdoc-fr/reference/imap/functions/imap-search.xml Wed Feb 5 22:49:01 2003 @@ -10,12 +10,12 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>imap_search</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>criteria</parameter></methodparam> - <methodparam><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>imap_search</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>criteria</parameter></methodparam> + <methodparam><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> <para> <function>imap_search</function> effectue une recherche dans la boîte aux lettres courante, sur le flot <acronym>IMAP</acronym> courant. Index: phpdoc-fr/reference/imap/functions/imap-set-quota.xml diff -u phpdoc-fr/reference/imap/functions/imap-set-quota.xml:1.1 phpdoc-fr/reference/imap/functions/imap-set-quota.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-set-quota.xml:1.1 Sun Apr 14 20:31:01 2002 +++ phpdoc-fr/reference/imap/functions/imap-set-quota.xml Wed Feb 5 22:49:01 2003 @@ -8,12 +8,12 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_set_quota</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>quota_root</parameter></methodparam> - <methodparam><type>int</type><parameter>quota_limit</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_set_quota</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>quota_root</parameter></methodparam> + <methodparam><type>int</type><parameter>quota_limit</parameter></methodparam> + </methodsynopsis> <para> <function>imap_set_quota</function> modifie le quota de la boîte aux lettres <parameter>quota_root</parameter>, en la @@ -46,14 +46,19 @@ <example> <title>Exemple avec <function>imap_set_quota</function></title> <programlisting role="php"> -<?php -$mbox = imap_open ("{votre.hote.imap:143}", "mailadmin", "mot de passe"); -if(!imap_set_quota($mbox, "user.toto", 3000)) { - print "Erreur lors de la modification des quotas\n"; - return; +<![CDATA[ +<?php +$mbox = imap_open ("{your.imap.host:143}", "mailadmin", "password"); + +if(!imap_set_quota($mbox, "user.kalowsky", 3000)) { + print "Error in setting quota\n"; + return; } + imap_close($mbox); -?> +?> +]]> + </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-setflag-full.xml diff -u phpdoc-fr/reference/imap/functions/imap-setflag-full.xml:1.1 phpdoc-fr/reference/imap/functions/imap-setflag-full.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-setflag-full.xml:1.1 Sun Apr 14 20:31:02 2002 +++ phpdoc-fr/reference/imap/functions/imap-setflag-full.xml Wed Feb 5 22:49:01 2003 @@ -4,17 +4,17 @@ <refentry id="function.imap-setflag-full"> <refnamediv> <refname>imap_setflag_full</refname> - <refpurpose>Positionne un flag sur un message.</refpurpose> + <refpurpose>Positionne un flag sur un message</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>imap_setflag_full</methodname> - <methodparam><type>int</type><parameter>stream</parameter></methodparam> - <methodparam><type>string</type><parameter>sequence</parameter></methodparam> - <methodparam><type>string</type><parameter>flag</parameter></methodparam> - <methodparam><type>string</type><parameter>options</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_setflag_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><type>string</type><parameter>options</parameter></methodparam> + </methodsynopsis> <para> <function>imap_setflag_full</function> affecte le flag spécifié aux messages de la sequence donné. @@ -37,14 +37,19 @@ <example> <title>Exemple avec <function>imap_setflag_full</function></title> <programlisting role="php"> -<?php -$mbox = imap_open("{votre.hote.imap:143}","utilisateur","mot_de_passe") - or die("can't connect: ".imap_last_error()); +<![CDATA[ +<?php +$mbox = imap_open("{your.imap.host:143}","username","password") + or die("can't connect: ".imap_last_error()); + $status = imap_setflag_full($mbox,"2,5","\\Seen \\Flagged"); + print gettype($status)."\n"; print $status."\n"; + imap_close($mbox); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/imap/functions/imap-sort.xml diff -u phpdoc-fr/reference/imap/functions/imap-sort.xml:1.1 phpdoc-fr/reference/imap/functions/imap-sort.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-sort.xml:1.1 Sun Apr 14 20:31:02 2002 +++ phpdoc-fr/reference/imap/functions/imap-sort.xml Wed Feb 5 22:49:01 2003 @@ -4,17 +4,18 @@ <refentry id="function.imap-sort"> <refnamediv> <refname>imap_sort</refname> - <refpurpose>Trie des messages.</refpurpose> + <refpurpose>Trie des messages</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>imap_sort</methodname> - <methodparam><type>int</type><parameter>stream</parameter></methodparam> - <methodparam><type>int</type><parameter>criteria</parameter></methodparam> - <methodparam><type>int</type><parameter>reverse</parameter></methodparam> - <methodparam><type>int</type><parameter>options</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>imap_sort</methodname> + <methodparam><type>resource</type><parameter>stream</parameter></methodparam> + <methodparam><type>int</type><parameter>criteria</parameter></methodparam> + <methodparam><type>int</type><parameter>reverse</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>search_criteria</parameter></methodparam> + </methodsynopsis> <para> <function>imap_sort</function> retourne un tableau de nombre de message, triés suivant les paramètres suivants : Index: phpdoc-fr/reference/imap/functions/imap-subscribe.xml diff -u phpdoc-fr/reference/imap/functions/imap-subscribe.xml:1.1 phpdoc-fr/reference/imap/functions/imap-subscribe.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-subscribe.xml:1.1 Sun Apr 14 20:31:04 2002 +++ phpdoc-fr/reference/imap/functions/imap-subscribe.xml Wed Feb 5 22:49:01 2003 @@ -4,23 +4,22 @@ <refentry id="function.imap-subscribe"> <refnamediv> <refname>imap_subscribe</refname> - <refpurpose>Souscrit à une boîte aux lettres.</refpurpose> + <refpurpose>Souscrit à une boîte aux lettres</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_subscribe</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>mbox</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_subscribe</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>mbox</parameter></methodparam> + </methodsynopsis> <para> <function>imap_subscribe</function> souscrit à la boîte aux lettres <parameter>mbox</parameter>. </para> - <para> - <function>imap_subscribe</function> retourne &true; en cas de - succès, et &false; en cas d'échec. - </para> + <para> + &return.success; + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/imap/functions/imap-undelete.xml diff -u phpdoc-fr/reference/imap/functions/imap-undelete.xml:1.1 phpdoc-fr/reference/imap/functions/imap-undelete.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-undelete.xml:1.1 Sun Apr 14 20:31:05 2002 +++ phpdoc-fr/reference/imap/functions/imap-undelete.xml Wed Feb 5 22:49:01 2003 @@ -4,26 +4,23 @@ <refentry id="function.imap-undelete"> <refnamediv> <refname>imap_undelete</refname> - <refpurpose> - Enlève la marque d'effacement d'un message. - </refpurpose> + <refpurpose>Enlève la marque d'effacement d'un message</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_undelete</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>int</type><parameter>msg_number</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_undelete</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>int</type><parameter>msg_number</parameter></methodparam> + </methodsynopsis> <para> <function>imap_undelete</function> enlève la marque d'effacement du message <parameter>msg_number</parameter>, placée avec <function>imap_delete</function>. </para> - <para> - <function>imap_subscribe</function> retourne &true; en cas - de succès, et &false; en cas d'erreur. - </para> + <para> + &return.success; + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml diff -u phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml:1.1 phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml:1.2 --- phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml:1.1 Sun Apr 14 20:31:05 2002 +++ phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml Wed Feb 5 22:49:01 2003 @@ -4,17 +4,15 @@ <refentry id="function.imap-unsubscribe"> <refnamediv> <refname>imap_unsubscribe</refname> - <refpurpose> - Termine la souscription à une boîte aux lettres. - </refpurpose> + <refpurpose>Termine la souscription à une boîte aux lettres</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>imap_unsubscribe</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>mbox</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>imap_unsubscribe</methodname> + <methodparam><type>string</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>mbox</parameter></methodparam> + </methodsynopsis> <para> <function>imap_unsubscribe</function> termine la souscription à la boîte aux lettres <parameter>mbox</parameter>.