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: 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&egrave;s &agrave; 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&eacute; la librairie C-client. - Chargez sa derni&egrave;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&eacute;l&eacute;chargez + cette derni&egrave;re version &agrave; <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&eacute;es au protocole - <acronym>IMAP</acronym>, malgr&eacute; leur nom. La librairie sur laquelle - elles sont d&eacute;velopp&eacute;es supporte aussi <acronym>NNTP</acronym>, - <acronym>POP3</acronym> et les m&eacute;thodes d'acc&egrave;s aux - bo&icirc;tes aux lettres locales. Reportez-vous &agrave; 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&eacute;pend de votre OS. + Assurez vous que ces fichiers sont bien copi&eacute;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&eacute;tails de toutes les sujets abord&eacute;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 &amp; Kevin Mullet. - </para> - </partintro> + </para> + <warning> + <para> + Des crashs et des probl&egrave;mes de d&eacute;marrage de &php; sont possibles lorsque + vous chargez cette extension en m&ecirc;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&icirc;ne &agrave; 8 bits - en une cha&icirc;ne &agrave; guillemets. + en une cha&icirc;ne &agrave; guillemets + (selon la <ulink url="&url.rfc;rfc2045.html">RFC 2045</ulink>, Section 6.7). </para> <para> <function>imap_8bit</function> retourne une cha&icirc;ne &agrave; 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&icirc;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&egrave;s, et &false; en cas d'erreur. + &return.sucess; </para> <para> Lors des &eacute;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"> -&lt;?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&egrave;s ajout : ". $check->Nmsgs."\n"; imap_close($stream); -?&gt; +?> +]]> </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&eacute;code un texte encod&eacute; en BASE64.</refpurpose> + <refpurpose>D&eacute;code un texte encod&eacute; en BASE64</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -15,7 +15,8 @@ <para> <function>imap_base64</function> d&eacute;code un texte encod&eacute; en BASE64. Le texte d&eacute;cod&eacute; est retourn&eacute; sous la - forme d'une cha&icirc;ne. + forme d'une cha&icirc;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&icirc;ne &agrave; - 8 bits <parameter>string</parameter> en une cha&icirc;ne &agrave; base64. + 8 bits <parameter>string</parameter> en une cha&icirc;ne &agrave; base64 + (selon la <ulink url="&url.rfc;rfc2045.html">RFC 2045</ulink>, Section 6.8). </para> <para> <function>imap_binary</function> retourne la cha&icirc;ne cod&eacute;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&eacute;ro <parameter>msg_number</parameter> de la bo&icirc;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&eacute;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 dŽfinis 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&eacute;e une nouvelle bo&icirc;te aux lettres.</refpurpose> + <refpurpose>Cr&eacute;e une nouvelle bo&icirc;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&eacute;e une nouvelle bo&icirc;te aux lettres nomm&eacute;e <parameter>mbox</parameter>. Les noms @@ -27,44 +27,46 @@ <example> <title>Exemple avec <function>imap_createmailbox</function></title> <programlisting role="php"> -&lt;?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&eacute;x"); $newname = $name1; -echo "Le nouveau nom sera '$name1'&lt;br&gt;\n"; -# Nous allons cr&eacute;er maintenant une nouvelle bo&icirc;te aux lettres "phptestbox" -# dans votre dossier inbox, v&eacute;rifier son &eacute;tat et finalement, la supprimer -# pour remettre votre inbox dans son &eacute;tat initial. +echo "Le nouveau nom sera '$name1'<BR>\n"; +// Nous allons cr&eacute;er maintenant une nouvelle bo&icirc;te aux lettres "phptestbox" +// dans votre dossier inbox, v&eacute;rifier son &eacute;tat et finalement, la supprimer +// pour remettre votre inbox dans son &eacute;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&icirc;te '$name1' est dans l'&eacute;tat suivant :&lt;br&gt;\n"); - print("Messages: ". $status->messages )."&lt;br&gt;\n"; - print("R&eacute;cent: ". $status->recent )."&lt;br&gt;\n"; - print("Non lus: ". $status->unseen )."&lt;br&gt;\n"; - print("UID suivant: ". $status->uidnext )."&lt;br&gt;\n"; - print("UID validit&eacute;:". $status->uidvalidity)."&lt;br&gt;\n"; + print("Votre nouvelle bo&icirc;te '$name1' est dans l'&eacute;tat suivant :<BR>\n"); + print("Messages: ". $status->messages )."<BR>\n"; + print("R&eacute;cent: ". $status->recent )."<BR>\n"; + print("Non lus: ". $status->unseen )."<BR>\n"; + print("UID suivant: ". $status->uidnext )."<BR>\n"; + print("UID validit&eacute;:". $status->uidvalidity)."<BR>\n"; if(imap_renamemailbox($mbox,"{your.imap.host}INBOX.$newname","{your.imap.host}INBOX.$name2")) { - echo "renommage de la bo&icirc;te aux lettres '$name1' en '$name2'&lt;br&gt;\n"; + echo "renommage de la bo&icirc;te aux lettres '$name1' en '$name2'<BR>\n"; $newname=$name2; } else { - print "imap_renamemailbox sur la nouvelle bo&icirc;te aux lettres a &eacute;chou&eacute; : ".imap_last_error()."&lt;br&gt;\n"; + print "imap_renamemailbox sur la nouvelle bo&icirc;te aux lettres a &eacute;chou&eacute; : ".imap_last_error()."<BR>\n"; } } else { - print "imap_status sur la nouvelle bo&icirc;te aux lettres a &eacute;chou&eacute; : ".imap_last_error()."&lt;br&gt;\n"; + print "imap_status sur la nouvelle bo&icirc;te aux lettres a &eacute;chou&eacute; : ".imap_last_error()."<BR>\n"; } if(@imap_deletemailbox($mbox,"{your.imap.host}INBOX.$newname")) { - print "new mailbox supprim&eacute;e pour remettre tout en &eacute;tat&lt;br&gt;\n"; + print "new mailbox supprim&eacute;e pour remettre tout en &eacute;tat<BR>\n"; } else { - print "imap_deletemailbox ur la nouvelle bo&icirc;te aux lettres a &eacute;chou&eacute; : ".implode("&lt;br&gt;\n",imap_errors())."&lt;br&gt;\n"; + print "imap_deletemailbox ur la nouvelle bo&icirc;te aux lettres a &eacute;chou&eacute; : ".implode("<BR>\n",imap_errors())."<BR>\n"; } } else { - print "Impossible de cr&eacute;er une nouvelle bo&icirc;te aux lettres : ".implode("&lt;br&gt;\n",imap_errors())."&lt;br&gt;\n"; + print "Impossible de cr&eacute;er une nouvelle bo&icirc;te aux lettres : ".implode("<BR>\n",imap_errors())."<BR>\n"; } imap_close($mbox); -?&gt; +?> +]]> </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&icirc;te aux lettres courante. + Marque le fichier pour l'effacement, dans la bo&icirc;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"> -&lt;?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 . "&lt;br&gt;\n" ; +print "Nombre de messages avant effacement : " . $check->Nmsgs . "<BR>\n" ; imap_delete ($mbox, 1); $check = imap_mailboxmsginfo ($mbox); -print "Nombre de messages apr&egrave;s effacement: " . $check->Nmsgs . "&lt;br&gt;\n" ; +print "Nombre de messages apr&egrave;s effacement: " . $check->Nmsgs . "<BR>\n" ; imap_expunge ($mbox); $check = imap_mailboxmsginfo ($mbox); -print "Nombre de messages apr&egrave;s imap_expunge: " . $check->Nmsgs . "&lt;br&gt;\n" ; +print "Nombre de messages apr&egrave;s imap_expunge: " . $check->Nmsgs . "<BR>\n" ; imap_close ($mbox); -?&gt; +?> +]]> </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&icirc;te aux lettres.</refpurpose> + <refpurpose>Efface une bo&icirc;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&icirc;te aux lettres (voir <function>imap_open</function> pour conna&icirc;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&eacute;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&ecirc;tes des courriers &eacute;lectroniques de la s&eacute;quence <parameter>sequence</parameter> et retourne @@ -100,21 +100,26 @@ <example> <title>Exemple avec <function>imap_fetch_overview</function></title> <programlisting role="php"> -&lt;?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); -?&gt; +?> +]]> </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&icirc;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&ecirc;te d'un message.</refpurpose> + <refpurpose>Retourne l'en-t&ecirc;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&ecirc;te brute et - compl&egrave;te RFC 822 du message <parameter>msgno</parameter>, et le retourne + compl&egrave;te <ulink url="&url.rfc;rfc2822.html">RFC2822</ulink> + du message <parameter>msgno</parameter>, et le retourne sous la forme d'une cha&icirc;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&icirc;tes aux lettres. Chaque objet a les attributs @@ -73,23 +73,25 @@ <example> <title>Exemple avec <function>imap_getmailboxes</function></title> <programlisting role="php"> -&lt;?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."&lt;br&gt;\n"; - } -} else - print "imap_getmailboxes a &eacute;chou&eacute; : ".imap_last_error()."\n"; + print $val->attributes."<BR>\n"; + } +} else { + print "imap_getmailboxes a &eacute;chou&eacute; : ".imap_last_error()."\n"; +} imap_close($mbox); -?&gt; +?> +]]> </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&icirc;tes aux lettres souscrites.</refpurpose> + <refpurpose>Liste toutes les bo&icirc;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 &agrave; <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&ecirc;te d'un message.</refpurpose> + <refpurpose>Lit l'en-t&ecirc;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&icirc;tes aux lettres.</refpurpose> + <refpurpose>Liste les bo&icirc;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&icirc;tes aux lettres. @@ -22,7 +22,8 @@ <example> <title>Exemple avec <function>imap_listmailbox</function></title> <programlisting role="php"> -&lt;?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 &eacute;chou&eacute;: ".imap_last_error()."\n"; imap_close($mbox); -?&gt; +?> +]]> </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&icirc;tes aux lettres souscrites.</refpurpose> + <refpurpose>Liste les bo&icirc;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&eacute;cifi&eacute;s par <parameter>msglist</parameter> dans la bo&icirc;te aux lettres nomm&eacute;e <parameter>mbox</parameter>. <parameter>msglist</parameter> est un intervalle, et pas seulement - une liste num&eacute;ros de message. + une liste num&eacute;ros de message (comme d&eacute;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&eacute;place les messages sp&eacute;cifi&eacute;s - dans une bo&icirc;te aux lettres. + D&eacute;place des messages dans une bo&icirc;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&eacute;place les messages sp&eacute;cifi&eacute;s par <parameter>msglist</parameter> dans la bo&icirc;te aux lettres <parameter>mbox</parameter>. <parameter>msglist</parameter> est un intervalle, et pas seulement une - liste de messages. + liste de messages (comme d&eacute;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&egrave;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&icirc;te aux lettres.</refpurpose> + <refpurpose>Ouvre un flot IMAP vers une bo&icirc;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&egrave;s, et &false; en cas d'erreur. @@ -66,45 +66,55 @@ commande suivante : <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $mbox = imap_open("{localhost:143}INBOX","user_id","password"); -?&gt; +?> +]]> </programlisting> </informalexample> Pour se connecter &agrave; 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"> -&lt;?php +<![CDATA[ +<?php $mbox = imap_open("{localhost:110/pop3}INBOX","user_id","password"); -?&gt; +?> +]]> </programlisting> </informalexample> Pour se connecter &agrave; un serveur IMAP SSL ou POP3 SSL, ajoutez <literal>/ssl</literal> apr&egrave;s le protocole : <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $mbox = imap_open ("{localhost:993/imap/ssl}INBOX", "user_id", "password"); -?&gt; +?> +]]> </programlisting> </informalexample> Pour se connecter &agrave; un serveur SSL IMAP ou POP3 avec un certificat ajoutez <literal>/ssl/novalidate-cert</literal> apr&egrave;s le protocole : <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $mbox = imap_open ("{localhost:995/pop3/ssl/novalidate-cert}", "user_id", "password"); -?&gt; +?> +]]> </programlisting> </informalexample> Pour se connecter &agrave; un serveur <acronym>NNTP</acronym> qui fonctionne sur le port 119 de la machine locale on peut utiliser la commande: <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $nntp = imap_open("{localhost:119/nntp}comp.test","",""); -?&gt; +?> +]]> </programlisting> </informalexample> Pour se connecter &agrave; un serveur distant, remplacez "localhost" par @@ -114,7 +124,8 @@ <example> <title>Exemple avec <function>imap_open</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $mbox = imap_open ("{votre.hote.imap:143}", "nom_utilisateur", "mot de passe"); echo "&lt;p>&lt;h1>Mailboxes&lt;/h1>\n"; $folders = imap_listmailbox ($mbox, "{votre.hote.imap:143}", "*"); @@ -135,7 +146,8 @@ } } imap_close($mbox); -?&gt; +?> +]]> </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&eacute;rifie que le flot IMAP est toujours actif.</refpurpose> + <refpurpose>V&eacute;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 fl™t <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&icirc;ne &agrave; guillemets <parameter>string</parameter> en une cha&icirc;ne &agrave; - 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&icirc;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&icirc;te aux lettres.</refpurpose> + <refpurpose>Renomme une bo&icirc;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&icirc;te aux lettres <parameter>old_mbox</parameter> en <parameter>new_mbox</parameter>. </para> <para> - <function>imap_renamemailbox</function> retourne &true; - en cas de succ&egrave;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&eacute;ouvre la connexion sp&eacute;cifi&eacute;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&icirc;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&icirc;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&icirc;ne + <parameter>address</parameter>, tel que d&eacute;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"> -&lt;?php -$address_string = "Hartmut Holzgraefe &lt;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&icirc;te : ".$val->mailbox."&lt;br&gt;\n"; - print "h&ocirc;te : ".$val->host."&lt;br&gt;\n"; - print "personnel: ".$val->personal."&lt;br&gt;\n"; - print "adl : ".$val->adl."&lt;p>\n"; -} -?&gt; +<![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&icirc;te : ".$val->mailbox."<br>\n"; + print "h&ocirc;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&ecirc;te mail</refpurpose> + <refpurpose>Analyse une ent&ecirc;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&icirc;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&eacute;e - </refpurpose> + <refpurpose>Retourne une adresse email format&eacute;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&eacute;e, &agrave; partir du nom de la bo&icirc;te aux - lettres de l'h&ocirc;te <parameter>host</parameter>, et - des informations personnelles <parameter>personal</parameter>. + <parameter>mailbox</parameter> retourne une adresse email format&eacute;e + correctement selon la <ulink url="&url.rfc;rfc2822.html">RFC2822</ulink>, + &agrave; partir du nom de la bo&icirc;te aux lettres de l'h&ocirc;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"> -&lt;?php -print imap_rfc822_write_address("hartmut","cvs.php.net","Hartmut Holzgraefe")."\n"; -?&gt; +<![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&icirc;tes aux lettres, et y recherche une cha&icirc;ne. + Lit la liste des bo&icirc;tes aux lettres, et y recherche une cha&icirc;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&icirc;tes aux lettres qui contiennent la cha&icirc;ne - <parameter>string</parameter>. <function>imap_scanmailbox</function> - est simialaire &agrave; <function>imap_listmailbox</function>, - mais va aussi rechercher la cha&icirc;ne <parameter>string</parameter> dans - dans les donn&eacute;es de la bo&icirc;te aux lettres. Reportez-vous &agrave; - <function>imap_getmailboxes</function> pour une description des - param&egrave;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&icirc;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&icirc;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"> -&lt;?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); -?&gt; +?> +]]> + </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&eacute;cifi&eacute; aux messages de la sequence donn&eacute;. @@ -37,14 +37,19 @@ <example> <title>Exemple avec <function>imap_setflag_full</function></title> <programlisting role="php"> -&lt;?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); -?&gt; +?> +]]> </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&eacute;s suivant les param&egrave;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 &agrave; une bo&icirc;te aux lettres.</refpurpose> + <refpurpose>Souscrit &agrave; une bo&icirc;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 &agrave; la bo&icirc;te aux lettres <parameter>mbox</parameter>. </para> - <para> - <function>imap_subscribe</function> retourne &true; en cas de - succ&egrave;s, et &false; en cas d'&eacute;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&egrave;ve la marque d'effacement d'un message. - </refpurpose> + <refpurpose>Enl&egrave;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&egrave;ve la marque d'effacement du message <parameter>msg_number</parameter>, plac&eacute;e avec <function>imap_delete</function>. </para> - <para> - <function>imap_subscribe</function> retourne &true; en cas - de succ&egrave;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 &agrave; une bo&icirc;te aux lettres. - </refpurpose> + <refpurpose>Termine la souscription &agrave; une bo&icirc;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 &agrave; la bo&icirc;te aux lettres <parameter>mbox</parameter>.
« previous php.doc.fr (#210) next »