cvs: phpdoc-fr /reference/imap reference.xml /reference/imap/functions imap-mime-header-decode.xml imap-msgno.xml imap-num-msg.xml
imap-num-recent.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-savebody.xml imap-scanmailbox.xml imap-search.xml imap-set-quota.xml imap-setacl.xml
imap-setflag-full.xml imap-sort.xml imap-status.xml imap-subscribe.xml imap-thread.xml imap-timeout.xml imap-uid.xml imap-undelete.xml
imap-unsubscribe.xml imap-utf7-decode.xml imap-utf7-encode.xml imap-utf8.xml

yannick Tue Jan 30 18:40:50 2007 UTC Added files: /phpdoc-fr/reference/imap/functions imap-savebody.xml Modified files: /phpdoc-fr/reference/imap/functions imap-mime-header-decode.xml imap-msgno.xml imap-num-msg.xml imap-num-recent.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-setacl.xml imap-setflag-full.xml imap-set-quota.xml imap-sort.xml imap-status.xml imap-subscribe.xml imap-thread.xml imap-timeout.xml imap-uid.xml imap-undelete.xml imap-unsubscribe.xml imap-utf7-decode.xml imap-utf7-encode.xml imap-utf8.xml /phpdoc-fr/reference/imap reference.xml Log: sync with EN

http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-mime-header-decode.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-mime-header-decode.xml diff -u phpdoc-fr/reference/imap/functions/imap-mime-header-decode.xml:1.12 phpdoc-fr/reference/imap/functions/imap-mime-header-decode.xml:1.13 --- phpdoc-fr/reference/imap/functions/imap-mime-header-decode.xml:1.12 Wed Dec 14 15:42:20 2005 +++ phpdoc-fr/reference/imap/functions/imap-mime-header-decode.xml Tue Jan 30 18:40:50 2007 @@ -1,57 +1,96 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.9 Maintainer: didou Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-mime-header-decode"> - <refnamediv> - <refname>imap_mime_header_decode</refname> - <refpurpose>Décode les éléments MIME d'un en-tête</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>imap_mime_header_decode</methodname> - <methodparam><type>string</type><parameter>text</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_mime_header_decode</function> décode un message - MIME qui contient des données non ASCII - (voir <ulink url="&url.rfc;2047">RFC2047</ulink>). - Les éléments décodés sont retournés dans un tableau - d'objets. Chacun de ces objets a deux propriétés : - "charset" et "text". Si l'élément n'a pas été encodé, - ou, en d'autres termes, s'il est en clair (plain US_ASCII), - la propriété "charset" est mise à "default". - </para> - <para> - <example> - <title>Exemple <function>imap_mime_header_decode</function></title> - <programlisting role="php"> + +<refentry id="function.imap-mime-header-decode"> + <refnamediv> + <refname>imap_mime_header_decode</refname> + <refpurpose>Décode les éléments MIME d'un en-tête</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>imap_mime_header_decode</methodname> + <methodparam><type>string</type><parameter>text</parameter></methodparam> + </methodsynopsis> + <para> + Décode un message MIME qui contient des données non ASCII + (voir <ulink url="&url.rfc;2047">RFC2047</ulink>). + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>text</parameter></term> + <listitem> + <para> + Le texte MIME + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Les éléments décodés sont retournés dans un tableau + d'objets. Chacun de ces objets a deux propriétés : + <literal>charset</literal> et <literal>text</literal>. + </para> + <para> + Si l'élément n'a pas été encodé, ou, en d'autres termes, + s'il est en clair (plain US_ASCII), la propriété <literal>charset</literal> + est mise à <literal>default</literal>. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_mime_header_decode</function></title> + <programlisting role="php"> <![CDATA[ <?php - -$text="=?ISO-8859-1?Q?Keld_J=F8rn_Simonsen?= <keld@dkuug.dk>"; +$text = "=?ISO-8859-1?Q?Keld_J=F8rn_Simonsen?= <keld@example.com>"; $elements = imap_mime_header_decode($text); - -for($i=0; $i<count($elements); $i++) { - echo "Charset: {$elements[$i]->charset}\n"; - echo "Texte: {$elements[$i]->text}\n\n"; +for ($i=0; $i<count($elements); $i++) { + echo "Charset : {$elements[$i]->charset}\n"; + echo "Texte : {$elements[$i]->text}\n\n"; } ?> ]]> - </programlisting> - </example> - </para> - <para> - Dans l'exemple ci-dessus, on trouve deux éléments : le premier - a été encodé en ISO-8859-1, et le second est en clair. - </para> - <para> - Voyez aussi <function>imap_utf8</function>. - </para> - </refsect1> - </refentry> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Charset: ISO-8859-1 +Text: Keld Jørn Simonsen + +Charset: default +Text: <keld@example.com> +]]> + </screen> + </example> + </para> + <para> + Dans l'exemple ci-dessus, on trouve deux éléments : le premier + a été encodé en ISO-8859-1, et le second est en clair. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_utf8</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -72,4 +111,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-msgno.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-msgno.xml diff -u phpdoc-fr/reference/imap/functions/imap-msgno.xml:1.8 phpdoc-fr/reference/imap/functions/imap-msgno.xml:1.9 --- phpdoc-fr/reference/imap/functions/imap-msgno.xml:1.8 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-msgno.xml Tue Jan 30 18:40:50 2007 @@ -1,32 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-msgno"> - <refnamediv> - <refname>imap_msgno</refname> - <refpurpose> - Retourne le numéro de séquence de message pour un UID donné - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>imap_msgno</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>int</type><parameter>uid</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_msgno</function> retourne le numéro de séquence - de message pour l'UID <parameter>uid</parameter>. - C'est la fonction inverse de <function>imap_uid</function>. - </para> - <para> - Voir aussi - <function>imap_uid</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-msgno"> + <refnamediv> + <refname>imap_msgno</refname> + <refpurpose>Retourne le numéro de séquence du message pour un UID donné</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>imap_msgno</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>int</type><parameter>uid</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le numéro de séquence du message pour l'UID <parameter>uid</parameter>. + </para> + <para> + Cette fonction est l'inverse de la fonction <function>imap_uid</function>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>uid</parameter></term> + <listitem> + <para> + L'UID du message + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le numéro de séquence du message pour l'UID <parameter>uid</parameter>. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_uid</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -47,4 +73,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-num-msg.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-num-msg.xml diff -u phpdoc-fr/reference/imap/functions/imap-num-msg.xml:1.8 phpdoc-fr/reference/imap/functions/imap-num-msg.xml:1.9 --- phpdoc-fr/reference/imap/functions/imap-num-msg.xml:1.8 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-num-msg.xml Tue Jan 30 18:40:50 2007 @@ -1,31 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-num-msg"> - <refnamediv> - <refname>imap_num_msg</refname> - <refpurpose> - Retourne le nombre de message dans la boîte aux lettres courante - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>imap_num_msg</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_num_msg</function> retourne le nombre de - message dans la boîte aux lettres courante. - </para> - <para> - Voir aussi - <function>imap_num_recent</function> et - <function>imap_status</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-num-msg"> + <refnamediv> + <refname>imap_num_msg</refname> + <refpurpose>Retourne le nombre de messages dans la boîte aux lettres courante</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>imap_num_msg</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le nombre de messages dans la boîte aux lettres courante. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nombre de messages dans la boîte aux lettres courante, + sous la forme d'un &integer;. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_num_recent</function></member> + <member><function>imap_status</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -46,4 +63,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-num-recent.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-num-recent.xml diff -u phpdoc-fr/reference/imap/functions/imap-num-recent.xml:1.8 phpdoc-fr/reference/imap/functions/imap-num-recent.xml:1.9 --- phpdoc-fr/reference/imap/functions/imap-num-recent.xml:1.8 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-num-recent.xml Tue Jan 30 18:40:50 2007 @@ -1,32 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-num-recent"> - <refnamediv> - <refname>imap_num_recent</refname> - <refpurpose> - Retourne le nombre de messages récents dans la boîte - aux lettres courante - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>imap_num_recent</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_num_recent</function> retourne le nombre de - messages récents dans la boîte aux lettres courante. - </para> - <para> - Voir aussi - <function>imap_num_msg</function> et - <function>imap_status</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-num-recent"> + <refnamediv> + <refname>imap_num_recent</refname> + <refpurpose>Retourne le nombre de messages récents dans la boîte aux lettres courante</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>imap_num_recent</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + </methodsynopsis> + <para> + Retourne le nombre de messages récents dans la boîte aux lettres courante. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nombre de messages récents dans la boîte aux lettres courante, sous + la forme d'un &integer;. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_num_msg</function></member> + <member><function>imap_status</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -47,4 +63,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-open.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-open.xml diff -u phpdoc-fr/reference/imap/functions/imap-open.xml:1.18 phpdoc-fr/reference/imap/functions/imap-open.xml:1.19 --- phpdoc-fr/reference/imap/functions/imap-open.xml:1.18 Tue Jan 24 18:05:44 2006 +++ phpdoc-fr/reference/imap/functions/imap-open.xml Tue Jan 30 18:40:50 2007 @@ -1,294 +1,349 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.10 Maintainer: didou Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-open"> - <refnamediv> - <refname>imap_open</refname> - <refpurpose> - Ouvre un flux <acronym>IMAP</acronym> vers une boîte aux lettres - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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 flux <acronym>IMAP</acronym> - en cas de succès, et &false; en cas d'erreur. - <function>imap_open</function> peut aussi être utilisée pour - ouvrir des flots sur des serveurs <acronym>POP3</acronym> et <acronym>NNTP</acronym>. - </para> - <para> - Un nom de boîte aux lettres est constitué d'une adresse de serveur, - et d'une adresse de boîte sur ce serveur. Le mot réservé - <literal>INBOX</literal> représente la boîte aux lettres de - l'utilisateur courant. - L'adresse du serveur, mise entre accolades '{' et '}', est constituée - du nom du serveur ou de son adresse IP, d'une spécification de protocole - (commençant par '/') et d'un port optionnel (spécifié avec ':'). - Cette partie est obligatoire dans les paramètres de la boîte aux - lettres. Les noms de boîtes aux lettres qui contiennent des caractères - spéciaux (en dehors de l'espace ASCII) doivent être encodés - avec <function>imap_utf7_encode</function>. - </para> - <para> - Tous les noms commençant par <literal>{</literal> sont des noms distants et sont sous - la forme <literal>"{" nom_systeme_distant [":" port] [flags] "}" - [nom_mailbox]</literal> où : - <itemizedlist> - <listitem> - <simpara> - <literal>nom_systeme_distant</literal> - Nom de domaine Internet ou une - adresse IP de serveur entouré de guillemets. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>port</literal> - numéro de port TCP (optionnel), - la valeur par défaut est la valeur du port pour ce service. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>flags</literal> - flags optionnels, voir la table suivante. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>nom_mailbox</literal> - nom de la mailbox distante, par défaut : INBOX - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - <table> - <title>Flags optionnels pour les noms</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Flag</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry><literal>/service=</literal><emphasis>service</emphasis></entry> - <entry>service pourl'accès à la mailbox, par défaut : "imap"</entry> - </row> - <row> - <entry><literal>/user=</literal><emphasis>user</emphasis></entry> - <entry>nom de l'utilisateur distant pour l'identification sur le serveur</entry> - </row> - <row> - <entry><literal>/authuser=</literal><emphasis>user</emphasis></entry> - <entry>utilisateur distance d'identification ; si spécifié, ce sera le nom de l'utilisateur - dont le mot de passe est utilisé (e.g. administratur)</entry> - </row> - <row> - <entry><literal>/anonymous</literal></entry> - <entry>accès distant en anonyme</entry> - </row> - <row> - <entry><literal>/debug</literal></entry> - <entry>la télémétrie d'enregistrement du protocole dans les logs de débogage de - l'application</entry> - </row> - <row> - <entry><literal>/secure</literal></entry> - <entry>ne transmet pas un mot de passe en clair à travers le réseau</entry> - </row> - <row> - <entry><literal>/imap</literal>, <literal>/imap2</literal>, - <literal>/imap2bis</literal>, <literal>/imap4</literal>, - <literal>/imap4rev1</literal></entry> - <entry>équivalent de /service=imap</entry> - </row> - <row> - <entry><literal>/pop3</literal></entry> - <entry>équivalent de /service=pop3</entry> - </row> - <row> - <entry><literal>/nntp</literal></entry> - <entry>équivalent de /service=nntp</entry> - </row> - <row> - <entry><literal>/norsh</literal></entry> - <entry>ne pas utiliser rsh ou ssh pour établir une session de pré identification - IMAP</entry> - </row> - <row> - <entry><literal>/ssl</literal></entry> - <entry>utilise <literal>Secure Socket Layer</literal> pour crypter la - session</entry> - </row> - <row> - <entry><literal>/validate-cert</literal></entry> - <entry>valide les certificats depuis le serveur TLS/SSL (c'est le comportement par - défaut)</entry> - </row> - <row> - <entry><literal>/novalidate-cert</literal></entry> - <entry>ne pas valider les certificats depuis le serveur TLS/SSL, nécessaire si - le serveur utilise des certificats auto-signés</entry> - </row> - <row> - <entry><literal>/tls</literal></entry> - <entry>force l'utilisation de <literal>start-TLS</literal> pour crypter la session et - rejète les connexions aux serveurs qui ne le supporte pas</entry> - </row> - <row> - <entry><literal>/notls</literal></entry> - <entry>n'utilise pas <literal>start-TLS</literal> pour crypter la session, - y compris avec les serveurs qui le supporte</entry> - </row> - <row> - <entry><literal>/readonly</literal></entry> - <entry>demande un accès en lecture seule sur mailbox (IMAP uniquement ; ignoré sous - NNTP, et une erreur avec SMTP et POP3)</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - <parameter>options</parameter> est un masque de bit, qui peut prendre une ou - plusieurs des valeurs suivantes : - <itemizedlist> - <listitem> - <simpara> - <constant>OP_READONLY</constant> - Ouvre une boîte aux lettres en lecture seule - </simpara> - </listitem> - <listitem> - <simpara> - <constant>OP_ANONYMOUS</constant> - Ne pas utiliser, ou modifier le fichier .newsrc pour les news. - </simpara> - </listitem> - <listitem> - <simpara> - <constant>OP_HALFOPEN</constant> - Pour les noms <acronym>IMAP</acronym> et <acronym>NNTP</acronym>, - ouvre une connexion mais n'ouvre pas une boîte aux lettres. - </simpara> - </listitem> - <listitem> - <simpara> - <constant>CL_EXPUNGE</constant> - Supprime automatiquement la boîte aux lettres - de la liste, lors de la terminaison du flux (voir aussi - <function>imap_delete</function> and - <function>imap_expunge</function>) - </simpara> - </listitem> - <listitem> - <simpara> - <constant>OP_DEBUG</constant> - négociations de débogage du protocole - </simpara> - </listitem> - <listitem> - <simpara> - <constant>OP_SHORTCACHE</constant> - Cache court (elt uniquement) - </simpara> - </listitem> + +<refentry id="function.imap-open"> + <refnamediv> + <refname>imap_open</refname> + <refpurpose>Ouvre un flux <acronym>IMAP</acronym> vers une boîte aux lettres</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <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> + Ouvre un flux <acronym>IMAP</acronym> vers la boîte aux lettres + <parameter>mailbox</parameter>. + </para> + <para> + Cette fonction peut aussi être utilisée pour ouvrir des flots sur des + serveurs <acronym>POP3</acronym> et <acronym>NNTP</acronym> + mais quelques fonctions et fonctionnalités ne sont disponibles qu'avec les serveurs IMAP. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>mailbox</parameter></term> <listitem> - <simpara> - <constant>OP_SILENT</constant> - Ne pas transmettre les événements (utilisation - interne) - </simpara> + <para> + Un nom de boîte aux lettres est constitué d'une adresse de serveur, + et d'une adresse de boîte sur ce serveur. Le mot réservé + <literal>INBOX</literal> représente la boîte aux lettres de + l'utilisateur courant. Les noms de boîtes aux lettres qui contiennent + des caractères spéciaux (en dehors de l'espace ASCII) doivent être + encodés avec <function>imap_utf7_encode</function>. + </para> + <para> + L'adresse du serveur, mise entre accolades '{' et '}', est constituée + du nom du serveur ou de son adresse IP, d'une spécification de protocole + (commençant par '/') et d'un port optionnel (spécifié avec ':'). + </para> + <para> + Cette partie est obligatoire dans les paramètres de la boîte aux + lettres. + </para> + <para> + Tous les noms commençant par <literal>{</literal> sont des noms distants et sont sous + la forme <literal>"{" nom_systeme_distant [":" port] [flags] "}" + [nom_mailbox]</literal> où : + <itemizedlist> + <listitem> + <simpara> + <literal>remote_system_name</literal> - Nom de domaine Internet ou une + adresse IP de serveur entouré de guillemets. + </simpara> + </listitem> + <listitem> + <simpara> + <literal>port</literal> - numéro de port TCP (optionnel), + la valeur par défaut est la valeur du port pour ce service. + </simpara> + </listitem> + <listitem> + <simpara> + <literal>flags</literal> - flags optionnels, voir la table suivante. + </simpara> + </listitem> + <listitem> + <simpara> + <literal>mailbox_name</literal> - nom de la mailbox distante, par défaut : INBOX + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + <table> + <title>Flags optionnels pour les noms</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Flag</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>/service=</literal><emphasis>service</emphasis></entry> + <entry>service pourl'accès à la mailbox, par défaut : "imap"</entry> + </row> + <row> + <entry><literal>/user=</literal><emphasis>user</emphasis></entry> + <entry>nom de l'utilisateur distant pour l'identification sur le serveur</entry> + </row> + <row> + <entry><literal>/authuser=</literal><emphasis>user</emphasis></entry> + <entry>utilisateur distance d'identification ; si spécifié, ce sera le nom de l'utilisateur + dont le mot de passe est utilisé (e.g. administratur)</entry> + </row> + <row> + <entry><literal>/anonymous</literal></entry> + <entry>accès distant en anonyme</entry> + </row> + <row> + <entry><literal>/debug</literal></entry> + <entry>la télémétrie d'enregistrement du protocole dans les logs de débogage de + l'application</entry> + </row> + <row> + <entry><literal>/secure</literal></entry> + <entry>ne transmet pas un mot de passe en clair à travers le réseau</entry> + </row> + <row> + <entry><literal>/imap</literal>, <literal>/imap2</literal>, + <literal>/imap2bis</literal>, <literal>/imap4</literal>, + <literal>/imap4rev1</literal></entry> + <entry>équivalent de /service=imap</entry> + </row> + <row> + <entry><literal>/pop3</literal></entry> + <entry>équivalent de /service=pop3</entry> + </row> + <row> + <entry><literal>/nntp</literal></entry> + <entry>équivalent de /service=nntp</entry> + </row> + <row> + <entry><literal>/norsh</literal></entry> + <entry>ne pas utiliser rsh ou ssh pour établir une session de pré identification + IMAP</entry> + </row> + <row> + <entry><literal>/ssl</literal></entry> + <entry>utilise <literal>Secure Socket Layer</literal> pour crypter la + session</entry> + </row> + <row> + <entry><literal>/validate-cert</literal></entry> + <entry>valide les certificats depuis le serveur TLS/SSL (c'est le comportement par + défaut)</entry> + </row> + <row> + <entry><literal>/novalidate-cert</literal></entry> + <entry>ne pas valider les certificats depuis le serveur TLS/SSL, nécessaire si + le serveur utilise des certificats auto-signés</entry> + </row> + <row> + <entry><literal>/tls</literal></entry> + <entry>force l'utilisation de <literal>start-TLS</literal> pour crypter la session et + rejète les connexions aux serveurs qui ne le supporte pas</entry> + </row> + <row> + <entry><literal>/notls</literal></entry> + <entry>n'utilise pas <literal>start-TLS</literal> pour crypter la session, + y compris avec les serveurs qui le supporte</entry> + </row> + <row> + <entry><literal>/readonly</literal></entry> + <entry>demande un accès en lecture seule sur mailbox (IMAP uniquement ; ignoré sous + NNTP, et une erreur avec SMTP et POP3)</entry> + </row> + </tbody> + </tgroup> + </table> + </para> </listitem> + </varlistentry> + <varlistentry> + <term><parameter>username</parameter></term> <listitem> - <simpara> - <constant>OP_PROTOTYPE</constant> - Retourne le prototype du driver - </simpara> + <para> + Le nom d'utilisateur + </para> </listitem> + </varlistentry> + <varlistentry> + <term><parameter>password</parameter></term> <listitem> - <simpara> - <constant>OP_EXPUNGE</constant> - Nettoye silencieusement le flux recyclé - </simpara> + <para> + Le mot de passe associé avec l'utilisateur <parameter>username</parameter> + </para> </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> <listitem> - <simpara> - <constant>OP_SECURE</constant> - Ne pas effectuer des identifications non sécuritées - </simpara> + <para> + <parameter>options</parameter> est un masque de bit, qui peut prendre une ou + plusieurs des valeurs suivantes : + <itemizedlist> + <listitem> + <simpara> + <constant>OP_READONLY</constant> - Ouvre une boîte aux lettres en lecture seule + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_ANONYMOUS</constant> - Ne pas utiliser, ou modifier le fichier + <filename>.newsrc</filename> pour les news (NNTP uniquement) + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_HALFOPEN</constant> - Pour les noms <acronym>IMAP</acronym> et <acronym>NNTP</acronym>, + ouvre une connexion mais n'ouvre pas une boîte aux lettres. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>CL_EXPUNGE</constant> - Supprime automatiquement la boîte aux lettres + de la liste, lors de la terminaison du flux (voir aussi + <function>imap_delete</function> and + <function>imap_expunge</function>) + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_DEBUG</constant> - négociations de débogage du protocole + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_SHORTCACHE</constant> - Cache court (<literal>elt</literal> uniquement) + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_SILENT</constant> - Ne pas transmettre les événements (utilisation + interne) + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_PROTOTYPE</constant> - Retourne le prototype du driver + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_EXPUNGE</constant> - Nettoye silencieusement le flux recyclé + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_SECURE</constant> - Ne pas effectuer des identifications non sécuritées + </simpara> + </listitem> + </itemizedlist> + </para> </listitem> - </itemizedlist> - </para> - <para> - Pour se connecter à un serveur <acronym>IMAP</acronym>, on peut utiliser la - commande suivante : - <example> - <title>Différentes utilisations de <function>imap_open</function></title> - <programlisting role="php"> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un flux IMAP en cas de succès, ou &false; + si une erreur survient. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Différentes utilisations de <function>imap_open</function></title> + <programlisting role="php"> <![CDATA[ <?php // Pour se connecter à un serveur IMAP fonctionnant sur le port 143 de la // machine locale, faites ceci : -$mbox = imap_open("{localhost:143}INBOX","user_id","password"); +$mbox = imap_open("{localhost:143}INBOX", "user_id", "password"); // Pour se connecter à un serveur POP3 fonctionnant sur le port 110 du // serveur local, faites ceci : -$mbox = imap_open("{localhost:110/pop3}INBOX","user_id","password"); +$mbox = imap_open ("{localhost:110/pop3}INBOX", "user_id", "password"); // Pour se connecter à un serveur SSL IMAP ou POP3, ajoutez /ssl -// après la spécification du protocole -$mbox = imap_open("{localhost:993/imap/ssl}INBOX", "user_id", "password"); +// après la spécification du protocole : +$mbox = imap_open ("{localhost:993/imap/ssl}INBOX", "user_id", "password"); // Pour se connecter à un serveur SSL IMAP ou POP3 avec un certificat auto-signé // ajoutez /ssl/novalidate-cert après le protocole : -$mbox = imap_open("{localhost:995/pop3/ssl/novalidate-cert}", "user_id", "password"); +$mbox = imap_open ("{localhost:995/pop3/ssl/novalidate-cert}", "user_id", "password"); // Pour se connecter à un serveur NNTP qui fonctionne sur // le port 119 de la machine locale on peut utiliser la commande: -$nntp = imap_open("{localhost:119/nntp}comp.test","",""); +$nntp = imap_open ("{localhost:119/nntp}comp.test", "", ""); // Pour se connecter à un serveur distant, remplacez "localhost" par // le nom ou l'adresse IP de la machine. ?> ]]> - </programlisting> - </example> - </para> - <para> - <example> - <title>Exemple avec <function>imap_open</function></title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Exemple avec <function>imap_open</function></title> + <programlisting role="php"> <![CDATA[ <?php +$mbox = imap_open("{imap.example.org:143}", "username", "password"); -$mbox = imap_open("{imap.example.org:143}", "nom_utilisateur", "mot de passe"); echo "<h1>Mailboxes</h1>\n"; - $folders = imap_listmailbox($mbox, "{imap.example.org:143}", "*"); + if ($folders == false) { - echo "Appel échoué<br />\n"; + echo "Appel échoué<br />\n"; } else { - foreach ($folders as $val) { - echo $val . "<br />\n"; - } + foreach ($folders as $val) { + echo $val . "<br />\n"; + } } echo "<h1>en-têtes dans INBOX</h1>\n"; $headers = imap_headers($mbox); + if ($headers == false) { - echo "Appel échoué<br />\n"; + echo "Appel échoué<br />\n"; } else { - foreach ($headers as $val) { - echo $val . "<br />\n"; - } + foreach ($headers as $val) { + echo $val . "<br />\n"; + } } imap_close($mbox); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_close</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -309,4 +364,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-ping.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-ping.xml diff -u phpdoc-fr/reference/imap/functions/imap-ping.xml:1.13 phpdoc-fr/reference/imap/functions/imap-ping.xml:1.14 --- phpdoc-fr/reference/imap/functions/imap-ping.xml:1.13 Tue Jan 24 18:05:44 2006 +++ phpdoc-fr/reference/imap/functions/imap-ping.xml Tue Jan 30 18:40:50 2007 @@ -1,41 +1,52 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.6 Maintainer: didou Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-ping"> - <refnamediv> - <refname>imap_ping</refname> - <refpurpose>Vérifie que le flux IMAP est toujours actif</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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 flux <parameter>imap_stream</parameter> existe toujours, - et &false; sinon. - </para> - <para> - <function>imap_ping</function> vérifie que le flux - <acronym>IMAP</acronym> est toujours actif, en lui - envoyant un ping. Cette fonction permet de se rendre - compte qu'un mail est arrivé : c'est même la méthode - préconisée pour des tests périodiques de vérification - du courrier. Cette fonction peut aussi servir à garder - une connexion ouverte, avec les serveurs dotés d'un - délai d'expiration. - </para> - <para> - <example> - <title>Exemple avec <function>imap_ping</function></title> - <programlisting role="php"> + +<refentry id="function.imap-ping"> + <refnamediv> + <refname>imap_ping</refname> + <refpurpose>Vérifie que le flux IMAP est toujours actif</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imap_ping</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + </methodsynopsis> + <para> + Vérifie que le flux <acronym>IMAP</acronym> est toujours + actif, en lui envoyant un ping. Cette fonction permet de se + rendre compte qu'un mail est arrivé : c'est même la méthode + préconisée pour des tests périodiques de vérification du courrier. + Cette fonction peut aussi servir à garder une connexion ouverte, + avec les serveurs dotés d'un délai d'expiration. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; si le flux est toujours actif, &false; sinon. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_ping</function></title> + <programlisting role="php"> <![CDATA[ <?php -$imap = imap_open("{imap.example.org}", "mailadmin", "motdepasse"); +$imap = imap_open("{imap.example.org}", "mailadmin", "password"); // après une pause if (!imap_ping($imap)) { @@ -44,11 +55,11 @@ ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -69,4 +80,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-qprint.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-qprint.xml diff -u phpdoc-fr/reference/imap/functions/imap-qprint.xml:1.9 phpdoc-fr/reference/imap/functions/imap-qprint.xml:1.10 --- phpdoc-fr/reference/imap/functions/imap-qprint.xml:1.9 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-qprint.xml Tue Jan 30 18:40:50 2007 @@ -1,33 +1,55 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-qprint"> - <refnamediv> - <refname>imap_qprint</refname> - <refpurpose> - Convertit une chaîne à guillemets en une - chaîne à 8 bits - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>imap_qprint</methodname> - <methodparam><type>string</type><parameter>string</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_qprint</function> convertit la chaîne à - guillemets <parameter>string</parameter> en une chaîne à - 8 bits (selon la <ulink url="&url.rfc;2045">RFC2045</ulink>, - section 6.7). - </para> - <para> - Voir aussi - <function>imap_8bit</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-qprint"> + <refnamediv> + <refname>imap_qprint</refname> + <refpurpose>Convertit une chaîne à guillemets en une chaîne à 8 bits</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>imap_qprint</methodname> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + </methodsynopsis> + <para> + Convertit la chaîne à guillemets <parameter>string</parameter> + en une chaîne à 8 bits (selon la <ulink url="&url.rfc;2045">RFC2045</ulink>, + section 6.7). + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>string</parameter></term> + <listitem> + <para> + Une chaîne à guillemets + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne une &string; à 8 bits. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_8bit</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -48,4 +70,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml diff -u phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml:1.8 phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml:1.9 --- phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml:1.8 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-renamemailbox.xml Tue Jan 30 18:40:50 2007 @@ -1,36 +1,70 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-renamemailbox"> - <refnamediv> - <refname>imap_renamemailbox</refname> - <refpurpose>Renomme une boîte aux lettres</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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> - &return.success; - </para> - <para> - Voir aussi - <function>imap_createmailbox</function>, - <function>imap_deletemailbox</function> et - <function>imap_open</function> pour le - format de <parameter>mbox</parameter>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-renamemailbox"> + <refnamediv> + <refname>imap_renamemailbox</refname> + <refpurpose>Renomme une boîte aux lettres</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <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> + (voir la fonction <function>imap_open</function> our le format des noms + <parameter>mbox</parameter>). + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>old_mbox</parameter></term> + <listitem> + <para> + L'ancien nom de la boîte aux lettres, voir la documentation de la fonction + <function>imap_open</function> pour plus de détails + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>new_mbox</parameter></term> + <listitem> + <para> + Le nouveau nom de la boîte aux lettres, voir la documentation de la fonction + <function>imap_open</function> pour plus de détails + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_createmailbox</function></member> + <member><function>imap_deletemailbox</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -51,4 +85,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-reopen.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-reopen.xml diff -u phpdoc-fr/reference/imap/functions/imap-reopen.xml:1.13 phpdoc-fr/reference/imap/functions/imap-reopen.xml:1.14 --- phpdoc-fr/reference/imap/functions/imap-reopen.xml:1.13 Mon Jun 19 19:51:42 2006 +++ phpdoc-fr/reference/imap/functions/imap-reopen.xml Tue Jan 30 18:40:50 2007 @@ -1,61 +1,89 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.9 Maintainer: didou Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-reopen"> - <refnamediv> - <refname>imap_reopen</refname> - <refpurpose> - Réouvre un flux IMAP vers une nouvelle boîte aux lettres - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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>int</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>, - avec une nouvelle boîtes aux lettres. - </para> - <para> - <parameter>options</parameter> est un masque de bit, qui peut contenir les valeurs suivantes : - <itemizedlist> - <listitem> - <simpara> - <constant>OP_READONLY</constant> - Ouvre une boîte aux lettres en lecture seule - </simpara> - </listitem> - <listitem> - <simpara> - <constant>OP_ANONYMOUS</constant> - Ne pas utiliser, ou modifier le fichier .newsrc pour les news - </simpara> - </listitem> + +<refentry id="function.imap-reopen"> + <refnamediv> + <refname>imap_reopen</refname> + <refpurpose>Réouvre un flux IMAP vers une nouvelle boîte aux lettres</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <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>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <para> + Réouvre la connexion spécifiée au serveur <acronym>IMAP</acronym> + ou <acronym>NNTP</acronym>, avec une nouvelle boîtes aux lettres. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>mailbox</parameter></term> <listitem> - <simpara> - <constant>OP_HALFOPEN</constant> - Pour les noms <acronym>IMAP</acronym> et <acronym>NNTP</acronym>, - ouvre une connexion mais n'ouvre pas une boîte aux lettres. - </simpara> + <para> + Le nom de la boîte aux lettres, voir la documentation de la fonction + <function>imap_open</function> pour plus de détails + </para> </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> <listitem> - <simpara> - <constant>CL_EXPUNGE</constant> - Supprime automatiquement la boîte aux lettres de la liste, - lors de la terminaison du flux. (voir <function>imap_delete</function> et - <function>imap_expunge</function>). - </simpara> + <para> + <parameter>options</parameter> est un masque de bit, qui peut contenir les valeurs suivantes : + <itemizedlist> + <listitem> + <simpara> + <constant>OP_READONLY</constant> - Ouvre une boîte aux lettres en lecture seule + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_ANONYMOUS</constant> - Ne pas utiliser, ou modifier le fichier + <filename>.newsrc</filename> pour les news (NNTP uniquement) + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_HALFOPEN</constant> - Pour les noms <acronym>IMAP</acronym> et <acronym>NNTP</acronym>, + ouvre une connexion mais n'ouvre pas une boîte aux lettres. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>CL_EXPUNGE</constant> - Supprime automatiquement la boîte aux lettres de la liste, + lors de la terminaison du flux. (voir <function>imap_delete</function> et + <function>imap_expunge</function>). + </simpara> + </listitem> + </itemizedlist> + </para> </listitem> - </itemizedlist> - </para> - <para> - &return.success; - </para> - <example> - <title>Exemple avec <function>imap_reopen</function></title> - <programlisting role="php"> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_reopen</function></title> + <programlisting role="php"> <![CDATA[ <?php $mbox = imap_open("{imap.example.org:143}INBOX", "username", "password") or die(implode(", ", imap_errors())); @@ -64,10 +92,11 @@ // .. ?> ]]> - </programlisting> - </example> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -88,4 +117,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml diff -u phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml:1.9 phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml:1.10 --- phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml:1.9 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-rfc822-parse-adrlist.xml Tue Jan 30 18:40:50 2007 @@ -1,77 +1,136 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.8 Maintainer: didou Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-rfc822-parse-adrlist"> - <refnamediv> - <refname>imap_rfc822_parse_adrlist</refname> - <refpurpose>Analyse une adresse email</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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>imap_rfc822_parse_adrlist</parameter> analyse la chaîne - <parameter>address</parameter>, tel que définie dans la - <ulink url="&url.rfc;2822">RFC2822</ulink> et essaie, pour chaque adresse, - de retourner un tableau d'objets. Les 4 membres de ces objets sont : - </para> - <para> - <itemizedlist> - <listitem> - <simpara> - mailbox - Le nom de la boîte aux lettres (nom d'utilisateur) - </simpara> - </listitem> - <listitem> - <simpara> - host - Le nom de l'hôte - </simpara> - </listitem> + +<refentry id="function.imap-rfc822-parse-adrlist"> + <refnamediv> + <refname>imap_rfc822_parse_adrlist</refname> + <refpurpose>Analyse une adresse email</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <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> + Analyse la chaîne <parameter>address</parameter>, + tel que définie dans la <ulink url="&url.rfc;2822">RFC2822</ulink>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>address</parameter></term> <listitem> - <simpara> - personal - Le nom personnel - </simpara> + <para> + Une &string; contenant les adresses + </para> </listitem> + </varlistentry> + <varlistentry> + <term><parameter>default_host</parameter></term> <listitem> - <simpara> - adl - at domain source route (NDT : ???). - </simpara> + <para> + Le nom de l'hôte par défaut + </para> </listitem> - </itemizedlist> - </para> - <para> - <example> - <title>Exemple avec <function>imap_rfc822_parse_adrlist</function></title> - <programlisting role="php"> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau d'objets. Les propriétés des objets sont : + </para> + <para> + <itemizedlist> + <listitem> + <simpara> + mailbox - Le nom de la boîte aux lettres (nom d'utilisateur) + </simpara> + </listitem> + <listitem> + <simpara> + host - Le nom de l'hôte + </simpara> + </listitem> + <listitem> + <simpara> + personal - Le nom personnel + </simpara> + </listitem> + <listitem> + <simpara> + adl - at domain source route (NDT : ???) + </simpara> + </listitem> + </itemizedlist> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_rfc822_parse_adrlist</function></title> + <programlisting role="php"> <![CDATA[ <?php -$address_string = "Hartmut Holzgraefe <hartmut@cvs.php.net>, postmaster@somedomain.net, root"; -$address_array = imap_rfc822_parse_adrlist($address_string, "somedomain.net"); +$address_string = "Joe Doe <doe@example.com>, postmaster@example.com, root"; +$address_array = imap_rfc822_parse_adrlist($address_string, "example.com"); if (!is_array($address_array) || count($address_array) < 1) { - die("Erreur!\n"); + die("Erreur !\n"); } -reset($address_array); -while(list($key, $val) = each($address_array)) { - echo "boîte : " . $val->mailbox . "<br />\n"; - echo "hôte : " . $val->host . "<br />\n"; - echo "nom : " . $val->personal . "<br />\n"; - echo "adl : " . $val->adl . "<br />\n"; -} +foreach ($address_array as $id => $val) { + echo "# $id\n"; + echo " Boîte : " . $val->mailbox . "\n"; + echo " Hôte : " . $val->host . "\n"; + echo " Nom : " . $val->personal . "\n"; + echo " adl : " . $val->adl . "\n"; +} ?> ]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +# 0 + Boîte : doe + Hôte : example.com + Nom : Joe Doe + adl : +# 1 + Boîte : postmaster + hôte : example.com + Nom : + adl : +# 2 + Boîte : root + Hôte : example.com + Nom : + adl : - </programlisting> - </example> - </para> - </refsect1> - </refentry> +]]> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_rfc822_parse_headers</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -92,4 +151,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml diff -u phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml:1.10 phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml:1.11 --- phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml:1.10 Fri Dec 16 15:45:47 2005 +++ phpdoc-fr/reference/imap/functions/imap-rfc822-parse-headers.xml Tue Jan 30 18:40:50 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.2 Maintainer: didou Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry id="function.imap-rfc822-parse-headers"> @@ -8,7 +8,7 @@ <refname>imap_rfc822_parse_headers</refname> <refpurpose>Analyse un en-tête mail</refpurpose> </refnamediv> - <refsect1> + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>object</type><methodname>imap_rfc822_parse_headers</methodname> @@ -16,11 +16,48 @@ <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 + Analyse la chaîne <parameter>headers</parameter> et retourne un objet contenant différents éléments, similaires à la fonction - <function>imap_header</function>, hormis les flags et autres - éléments liés au serveur <acronym>IMAP</acronym>. + <function>imap_header</function>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>headers</parameter></term> + <listitem> + <para> + Les données à analyser + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>defaulthost</parameter></term> + <listitem> + <para> + Le nom de l'hôte par défaut + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un objet similaire à celui retourné par la fonction + <function>imap_header</function>, excepté pour les drapeaux + et les autres propriétés qui proviennent du serveur IMAP. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_rfc822_parse_adrlist</function></member> + </simplelist> </para> </refsect1> </refentry> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml diff -u phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml:1.10 phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml:1.11 --- phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml:1.10 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-rfc822-write-address.xml Tue Jan 30 18:40:50 2007 @@ -1,42 +1,87 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.8 Maintainer: didou Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-rfc822-write-address"> - <refnamediv> - <refname>imap_rfc822_write_address</refname> - <refpurpose>Retourne une adresse email formatée correctement</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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> - <function>imap_rfc822_write_address</function> retourne - une adresse email formatée correctement selon la <ulink - url="&url.rfc;2822">RFC2822</ulink>, à partir du - nom de la boîte aux lettres <parameter>mailbox</parameter> - de l'hôte <parameter>host</parameter>, et des informations - personnelles <parameter>personal</parameter>. + +<refentry id="function.imap-rfc822-write-address"> + <refnamediv> + <refname>imap_rfc822_write_address</refname> + <refpurpose>Retourne une adresse email formatée correctement</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <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> + Retourne une adresse email formatée correctement selon la <ulink + url="&url.rfc;2822">RFC2822</ulink>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>mailbox</parameter></term> + <listitem> + <para> + Le nom de la boîte aux lettres, voir la documentation de la fonction + <function>imap_open</function> pour plus de détails + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>host</parameter></term> + <listitem> + <para> + La partie hôte de l'email + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>personal</parameter></term> + <listitem> + <para> + Le nom du propriétaire du compte + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne une adresse email, sous la forme d'une &string;, formatée + correctement selon la <ulink url="&url.rfc;2822">RFC2822</ulink>. </para> - <para> - <example> - <title>Exemple avec <function>imap_rfc822_write_address</function></title> - <programlisting role="php"> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_rfc822_write_address</function></title> + <programlisting role="php"> <![CDATA[ <?php -echo imap_rfc822_write_address("hartmut", "cvs.php.net", "Hartmut Holzgraefe")."\n"; +echo imap_rfc822_write_address("hartmut", "example.com", "Hartmut Holzgraefe"); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Hartmut Holzgraefe <hartmut@example.com> +]]> + </screen> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -57,4 +102,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml diff -u phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml:1.11 phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml:1.12 --- phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml:1.11 Fri May 27 22:53:30 2005 +++ phpdoc-fr/reference/imap/functions/imap-scanmailbox.xml Tue Jan 30 18:40:50 2007 @@ -1,13 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> + <refentry id="function.imap-scanmailbox"> <refnamediv> <refname>imap_scanmailbox</refname> <refpurpose>&Alias; <function>imap_listscan</function></refpurpose> </refnamediv> - + <refsect1 role="description"> &reftitle.description; <simpara> @@ -36,4 +37,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-search.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-search.xml diff -u phpdoc-fr/reference/imap/functions/imap-search.xml:1.16 phpdoc-fr/reference/imap/functions/imap-search.xml:1.17 --- phpdoc-fr/reference/imap/functions/imap-search.xml:1.16 Wed Sep 13 03:05:59 2006 +++ phpdoc-fr/reference/imap/functions/imap-search.xml Tue Jan 30 18:40:50 2007 @@ -1,173 +1,237 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.7 Maintainer: didou Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-search"> - <refnamediv> - <refname>imap_search</refname> - <refpurpose> - Retourne un tableau de message après recherche - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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 choice="opt"><type>int</type><parameter>options</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_search</function> effectue une recherche dans la boîte aux - lettres courante, sur le flux <acronym>IMAP</acronym> courant. - <parameter>criteria</parameter> est une chaîne, délimitée - par des espaces, dans laquelle les mots-clés suivants sont acceptés. - Tous les arguments multi-mots doivent être entre guillemets : - <itemizedlist> - <listitem> - <simpara> - ALL - retourne tous les messages qui vérifient le reste du critère. - </simpara> - </listitem> - <listitem> - <simpara> - ANSWERED - tous les messages avec le flag \\ANSWERED - </simpara> - </listitem> - <listitem> - <simpara> - BCC "string" - tous les messages avec la chaîne "string" dans le - champ Bcc : - </simpara> - </listitem> - <listitem> - <simpara> - BEFORE "date" - tous les messages avec Date : avant "date" - </simpara> - </listitem> - <listitem> - <simpara> - BODY "string" - tous les messages avec "string" dans le corps - </simpara> - </listitem> - <listitem> - <simpara> - CC "string" - tous les messages avec "string" dans le champ Cc : - </simpara> - </listitem> - <listitem> - <simpara> - DELETED - tous les messages effacés - </simpara> - </listitem> - <listitem> - <simpara> - FLAGGED - tous les messages avec le flag \\FLAGGED (parfois - interprété comme Important ou Urgent) - </simpara> - </listitem> - <listitem> - <simpara> - FROM "string" - tous les messages avec la chaîne "string" dans le - champ From : - </simpara> - </listitem> - <listitem> - <simpara> - KEYWORD "string" - tous les messages avec la chaîne "string" comme mot-clé - </simpara> - </listitem> - <listitem> - <simpara> - NEW - tous les nouveaux messages - </simpara> - </listitem> - <listitem> - <simpara> - OLD - tous les anciens messages - </simpara> - </listitem> - <listitem> - <simpara> - ON "date" - tous les messages avec la date "date" comme champ Date : - </simpara> - </listitem> - <listitem> - <simpara> - RECENT - tous les messages avec le flag \\RECENT - </simpara> - </listitem> - <listitem> - <simpara> - SEEN - tous les messages lus (avec le flag\\SEEN flag) - </simpara> - </listitem> - <listitem> - <simpara> - SINCE "date" - tous les messages avec la date Date: après "date" - </simpara> - </listitem> - <listitem> - <simpara> - SUBJECT "string" - tous les messages avec la chaîne "string" - dans le champ Subject : - </simpara> - </listitem> - <listitem> - <simpara> - TEXT "string" - tous les messages avec le texte "string" - </simpara> - </listitem> - <listitem> - <simpara> - TO "string" - tous les messages avec la chaîne "string" dans le - champ To : - </simpara> - </listitem> - <listitem> - <simpara> - UNANSWERED - tous les messages non répondus - </simpara> - </listitem> - <listitem> - <simpara> - UNDELETED - tous les messages non effacés - </simpara> - </listitem> - <listitem> - <simpara> - UNFLAGGED - tous les messages non flaggés - </simpara> - </listitem> - <listitem> - <simpara> - UNKEYWORD "string" - tous les messages ne contenant pas le mot-clé "string" - </simpara> - </listitem> - <listitem> - <simpara> - UNSEEN - tous les messages non lus - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - Par exemple, pour rechercher les messages non répondus, envoyés - par maman, vous pouvez utiliser : "UNANSWERED FROM maman". Les recherches - semblent insensibles à la casse. Cette liste de critères est - issue du code d'un client C UW et peut être incomplète ou - inprécise. (voir aussi <ulink url="&url.rfc;2060">RFC2060</ulink>, section 6.4.4). - </para> - <para> - Les valeurs pour les flags sont SE_UID, qui fait que le tableau réponse - contient les UIDs plutôt que les numéros de séquence. - </para> - <para> - Le paramètre <parameter>charset</parameter> a été ajouté en &php; 4.3.3. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-search"> + <refnamediv> + <refname>imap_search</refname> + <refpurpose>Retourne un tableau de messages après recherche</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <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 choice="opt"><type>int</type><parameter>options</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> + </methodsynopsis> + <para> + Effectue une recherche dans la boîte aux lettres courante, sur le flux + <acronym>IMAP</acronym> courant. + </para> + <para> + Par exemple, pour rechercher les messages non répondus, envoyés + par maman, vous pouvez utiliser : "UNANSWERED FROM maman". Les recherches + semblent insensibles à la casse. Cette liste de critères est + issue du code d'un client C UW et peut être incomplète ou + inprécise. (voir aussi <ulink url="&url.rfc;2060">RFC2060</ulink>, section 6.4.4). + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>criteria</parameter></term> + <listitem> + <para> + Une &string;, délimitée par des espaces, dans laquelle les mots-clés + suivants sont acceptés. Tous les arguments multi-mots (e.g. FROM + "joey smith") doivent être entre guillemets : + <itemizedlist> + <listitem> + <simpara> + ALL - retourne tous les messages qui vérifient le reste du critère. + </simpara> + </listitem> + <listitem> + <simpara> + ANSWERED - tous les messages avec le flag \\ANSWERED + </simpara> + </listitem> + <listitem> + <simpara> + BCC "string" - tous les messages avec la chaîne "string" dans le + champ Bcc + </simpara> + </listitem> + <listitem> + <simpara> + BEFORE "date" - tous les messages avec Date : avant "date" + </simpara> + </listitem> + <listitem> + <simpara> + BODY "string" - tous les messages avec "string" dans le corps + </simpara> + </listitem> + <listitem> + <simpara> + CC "string" - tous les messages avec "string" dans le champ Cc + </simpara> + </listitem> + <listitem> + <simpara> + DELETED - tous les messages effacés + </simpara> + </listitem> + <listitem> + <simpara> + FLAGGED - tous les messages avec le flag \\FLAGGED (parfois + interprété comme Important ou Urgent) + </simpara> + </listitem> + <listitem> + <simpara> + FROM "string" - tous les messages avec la chaîne "string" dans le + champ From + </simpara> + </listitem> + <listitem> + <simpara> + KEYWORD "string" - tous les messages avec la chaîne "string" comme mot-clé + </simpara> + </listitem> + <listitem> + <simpara> + NEW - tous les nouveaux messages + </simpara> + </listitem> + <listitem> + <simpara> + OLD - tous les anciens messages + </simpara> + </listitem> + <listitem> + <simpara> + ON "date" - tous les messages avec la date "date" comme champ Date + </simpara> + </listitem> + <listitem> + <simpara> + RECENT - tous les messages avec le flag \\RECENT + </simpara> + </listitem> + <listitem> + <simpara> + SEEN - tous les messages lus (avec le flag\\SEEN flag) + </simpara> + </listitem> + <listitem> + <simpara> + SINCE "date" - tous les messages avec la date Date: après "date" + </simpara> + </listitem> + <listitem> + <simpara> + SUBJECT "string" - tous les messages avec la chaîne "string" + dans le champ Subject + </simpara> + </listitem> + <listitem> + <simpara> + TEXT "string" - tous les messages avec le texte "string" + </simpara> + </listitem> + <listitem> + <simpara> + TO "string" - tous les messages avec la chaîne "string" dans le + champ To + </simpara> + </listitem> + <listitem> + <simpara> + UNANSWERED - tous les messages non répondus + </simpara> + </listitem> + <listitem> + <simpara> + UNDELETED - tous les messages non effacés + </simpara> + </listitem> + <listitem> + <simpara> + UNFLAGGED - tous les messages non flaggés + </simpara> + </listitem> + <listitem> + <simpara> + UNKEYWORD "string" - tous les messages ne contenant pas le mot-clé "string" + </simpara> + </listitem> + <listitem> + <simpara> + UNSEEN - tous les messages non lus + </simpara> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> + <listitem> + <para> + Les valeurs pour les flags sont SE_UID, qui fait que le tableau réponse + contient les UIDs plutôt que les numéros de séquence. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>charset</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau de numéro de messages ou d'UIDs. + </para> + <para> + Retourne &false; si la recherche n'est pas comprise, ou bien qu'aucun + message n'a été trouvé. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.3</entry> + <entry> + Le paramètre <parameter>charset</parameter> a été ajouté. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_listscan</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -188,4 +252,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-setacl.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-setacl.xml diff -u phpdoc-fr/reference/imap/functions/imap-setacl.xml:1.8 phpdoc-fr/reference/imap/functions/imap-setacl.xml:1.9 --- phpdoc-fr/reference/imap/functions/imap-setacl.xml:1.8 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-setacl.xml Tue Jan 30 18:40:50 2007 @@ -1,36 +1,79 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-setacl"> - <refnamediv> - <refname>imap_setacl</refname> - <refpurpose> - Modifie le ACL de la boîte aux lettres - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>imap_setacl</methodname> - <methodparam><type>resource</type><parameter>stream_id</parameter></methodparam> - <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> - <methodparam><type>string</type><parameter>id</parameter></methodparam> - <methodparam><type>string</type><parameter>rights</parameter></methodparam> - </methodsynopsis> - <para> - &warn.undocumented.func; - </para> - <para> - <function>imap_setacl</function> n'est actuellement disponible que pour les - utilisateurs de la bibliothèque <literal>c-client2000</literal> ou supérieur. - </para> - <para> - Voir aussi - <function>imap_getacl</function>. - </para> - </refsect1> - </refentry> + +<refentry id='function.imap-setacl'> + <refnamediv> + <refname>imap_setacl</refname> + <refpurpose>Modifie le ACL de la boîte aux lettres</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imap_setacl</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> + <methodparam><type>string</type><parameter>id</parameter></methodparam> + <methodparam><type>string</type><parameter>rights</parameter></methodparam> + </methodsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>mailbox</parameter></term> + <listitem> + <para> + Le nom de la boîte aux lettres, voir la documentation de la fonction + <function>imap_open</function> pour plus de détails + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>id</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>rights</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <para> + Cette fonction n'est actuellement disponible que pour les utilisateurs + de la bibliothèque <literal>c-client2000</literal> ou supérieur. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_getacl</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -51,4 +94,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-setflag-full.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-setflag-full.xml diff -u phpdoc-fr/reference/imap/functions/imap-setflag-full.xml:1.12 phpdoc-fr/reference/imap/functions/imap-setflag-full.xml:1.13 --- phpdoc-fr/reference/imap/functions/imap-setflag-full.xml:1.12 Wed Sep 13 03:05:59 2006 +++ phpdoc-fr/reference/imap/functions/imap-setflag-full.xml Tue Jan 30 18:40:50 2007 @@ -1,51 +1,91 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.11 Maintainer: didou Status: ready --> -<!-- Reviewed: yes --> - <refentry id="function.imap-setflag-full"> - <refnamediv> - <refname>imap_setflag_full</refname> - <refpurpose>Positionne un flag sur un message</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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 choice="opt"><type>string</type><parameter>options</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_setflag_full</function> affecte le - <parameter>flag</parameter> spécifié aux messages de la - <parameter>sequence</parameter> donnée. - </para> - <para> - Les flags que vous pouvez modifier sont "\\Seen", "\\Answered", - "\\Flagged", "\\Deleted", "\\Draft" et "\\Recent" (comme défini dans - la <ulink url="&url.rfc;2060">RFC2060</ulink>). - </para> - <para> - <parameter>options</parameter> est un masque de bit, qui accepte - uniquement la valeur suivante : - <itemizedlist> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + +<refentry id="function.imap-setflag-full"> + <refnamediv> + <refname>imap_setflag_full</refname> + <refpurpose>Positionne un drapeau sur un message</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imap_setflag_full</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>sequence</parameter></methodparam> + <methodparam><type>string</type><parameter>flag</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <para> + <function>imap_setflag_full</function> affecte le + <parameter>flag</parameter> spécifié aux messages de la + <parameter>sequence</parameter> donnée. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>sequence</parameter></term> + <listitem> + <para> + Une séquence de numéro de messages. Vous pouvez énumérer les + messages désirés avec la synthaxe <literal>X,Y</literal>, ou + récupérer tous les messages d'un intervalle avec la synthaxe + <literal>X:Y</literal> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>flag</parameter></term> + <listitem> + <para> + Les flags que vous pouvez modifier sont <literal>\\Seen</literal>, + <literal>\\Answered</literal>, <literal>\\Flagged</literal>, + <literal>\\Deleted</literal>, et <literal>\\Draft</literal> (comme défini dans + la <ulink url="&url.rfc;2060">RFC2060</ulink>). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> <listitem> - <simpara> - <constant>ST_UID</constant> - la séquence contient des UID au lieu de - numéros de séquence. - </simpara> + <para> + <parameter>options</parameter> est un masque de bits, qui accepte + uniquement la valeur suivante : + <itemizedlist> + <listitem> + <simpara> + <constant>ST_UID</constant> - la séquence contient des UID au lieu de + numéros de séquence. + </simpara> + </listitem> + </itemizedlist> + </para> </listitem> - </itemizedlist> - </para> - <para> - <example> - <title>Exemple avec <function>imap_setflag_full</function></title> - <programlisting role="php"> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_setflag_full</function></title> + <programlisting role="php"> <![CDATA[ <?php -$mbox = imap_open("{imap.example.org:143}","username","password") - or die("can't connect: " . imap_last_error()); +$mbox = imap_open("{imap.example.org:143}", "username", "password") + or die("Connexion impossible : " . imap_last_error()); $status = imap_setflag_full($mbox, "2,5", "\\Seen \\Flagged"); @@ -55,15 +95,19 @@ imap_close($mbox); ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>imap_clearflag_full</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_clearflag_full</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -84,4 +128,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-set-quota.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-set-quota.xml diff -u phpdoc-fr/reference/imap/functions/imap-set-quota.xml:1.14 phpdoc-fr/reference/imap/functions/imap-set-quota.xml:1.15 --- phpdoc-fr/reference/imap/functions/imap-set-quota.xml:1.14 Tue Jan 24 18:05:44 2006 +++ phpdoc-fr/reference/imap/functions/imap-set-quota.xml Tue Jan 30 18:40:50 2007 @@ -1,74 +1,103 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.8 Maintainer: didou Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-set-quota"> - <refnamediv> - <refname>imap_set_quota</refname> - <refpurpose>Modifie le quota d'une boîte aux lettres</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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 - fixant à <parameter>quota_limit</parameter>. <function>imap_set_quota</function> - requiert que <parameter>imap_stream</parameter> ait été - ouvert avec un compte d'administrateur, pour avoir les droits - nécessaires : elle ne fonctionnera avec aucun autre - utilisateur. - </para> - <para> - <function>imap_get_quota</function> ne fonctionne actuellement qu'avec - les bibliothèques c-client2000. - </para> - <para> - <parameter>imap_stream</parameter> doit avoir été créé - avec la fonction <function>imap_open</function>. Ce flux est - nécessairement ouvert en tant qu'administrateur du serveur, pour que - les droits nécessaires lui soit alloués. - <parameter>quota_root</parameter> doit être de la forme : - "<literal>user.nom</literal>", où "nom" est le nom de la - boîte aux lettres que vous souhaitez analyser. - <parameter>quota_limit</parameter> est la nouvelle taille - maximum (en ko) de la boîte <parameter>quota_root</parameter>. - </para> - <para> - <function>imap_set_quota</function> retourne &true; - en cas de succès, et &false; sinon. - </para> - <para> - <example> - <title>Exemple avec <function>imap_set_quota</function></title> - <programlisting role="php"> + +<refentry id="function.imap-set-quota"> + <refnamediv> + <refname>imap_set_quota</refname> + <refpurpose>Modifie le quota d'une boîte aux lettres</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <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> + Modifie le quota de la boîte aux lettres <parameter>quota_root</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>quota_root</parameter></term> + <listitem> + <para> + La boîte aux lettres dont on doit modifier le quota. Elle doit suivre + le format standart IMAP pour une boîte aux lettres : + <literal>user.name</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>quota_limit</parameter></term> + <listitem> + <para> + La taille maximale (en Ko) pour la boîte <parameter>quota_root</parameter> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_set_quota</function></title> + <programlisting role="php"> <![CDATA[ <?php $mbox = imap_open("{imap.example.org:143}", "mailadmin", "password"); if (!imap_set_quota($mbox, "user.kalowsky", 3000)) { - echo "Error in setting quota\n"; + echo "Échec lors de la définition du quota\n"; return; } imap_close($mbox); ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>imap_open</function> et - <function>imap_get_quota</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <para> + <function>imap_get_quota</function> ne fonctionne actuellement qu'avec + les bibliothèques c-client2000. + </para> + <para> + <function>imap_set_quota</function> + requiert que <parameter>imap_stream</parameter> ait été + ouvert avec un compte d'administrateur, pour avoir les droits + nécessaires : elle ne fonctionnera avec aucun autre + utilisateur. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_open</function></member> + <member><function>imap_get_quota</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-sort.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-sort.xml diff -u phpdoc-fr/reference/imap/functions/imap-sort.xml:1.9 phpdoc-fr/reference/imap/functions/imap-sort.xml:1.10 --- phpdoc-fr/reference/imap/functions/imap-sort.xml:1.9 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-sort.xml Tue Jan 30 18:40:50 2007 @@ -1,97 +1,159 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-sort"> - <refnamediv> - <refname>imap_sort</refname> - <refpurpose>Trie des messages</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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> - <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_sort</function> retourne un tableau de - numéros de messages, triés en fonction des paramètres suivants : - </para> - <para> - <parameter>reverse</parameter> vaut 1 pour signifier : tri inverse. - </para> - <para> - Les critères <parameter>criteria</parameter> peuvent être - un (et un seul) parmi les suivants : - <itemizedlist> - <listitem> - <simpara> - <constant>SORTDATE</constant> - Date du message - </simpara> - </listitem> - <listitem> - <simpara> - <constant>SORTARRIVAL</constant> - Date d'arrivée - </simpara> - </listitem> - <listitem> - <simpara> - <constant>SORTFROM</constant> - Nom de la première boîte - aux lettres de l'adresse d'origine (From address) - </simpara> - </listitem> - <listitem> - <simpara> - <constant>SORTSUBJECT</constant> - Sujet du message - </simpara> - </listitem> - <listitem> - <simpara> - <constant>SORTTO</constant> - Nom de la première boîte aux - lettres de destination (To address) - </simpara> - </listitem> - <listitem> - <simpara> - <constant>SORTCC</constant> - Nom de la boîte aux lettres de - copie cachée (cc address) - </simpara> - </listitem> - <listitem> - <simpara> - <constant>SORTSIZE</constant> - Taille du message en octets - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - Les flags dont des masques de bits, d'un ou plusieurs des éléments - suivants : - <itemizedlist> - <listitem> - <simpara> - <constant>SE_UID</constant> - Retourne des UID à la place - de numéros - </simpara> - </listitem> + +<refentry id="function.imap-sort"> + <refnamediv> + <refname>imap_sort</refname> + <refpurpose>Trie des messages</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>imap_sort</methodname> + <methodparam><type>resource</type><parameter>imap_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> + <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> + </methodsynopsis> + <para> + Récupère et trie les numéros de messages en fonction des paramètres donnés. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>criteria</parameter></term> + <listitem> + <para> + Les critères <parameter>criteria</parameter> peuvent être + un (et un seul) parmi les suivants : + <itemizedlist> + <listitem> + <simpara> + <constant>SORTDATE</constant> - Date du message + </simpara> + </listitem> + <listitem> + <simpara> + <constant>SORTARRIVAL</constant> - Date d'arrivée + </simpara> + </listitem> + <listitem> + <simpara> + <constant>SORTFROM</constant> - Nom de la première boîte + aux lettres de l'adresse d'origine (From address) + </simpara> + </listitem> + <listitem> + <simpara> + <constant>SORTSUBJECT</constant> - Sujet du message + </simpara> + </listitem> + <listitem> + <simpara> + <constant>SORTTO</constant> - Nom de la première boîte aux + lettres de destination (To address) + </simpara> + </listitem> + <listitem> + <simpara> + <constant>SORTCC</constant> - Nom de la boîte aux lettres de + copie cachée (cc address) + </simpara> + </listitem> + <listitem> + <simpara> + <constant>SORTSIZE</constant> - Taille du message en octets + </simpara> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>reverse</parameter></term> + <listitem> + <para> + vaut 1 pour signifier : tri inverse + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> + <listitem> + <para> + Les flags <parameter>options</parameter> dont des masques de bits, + d'un ou plusieurs des éléments suivants : + <itemizedlist> + <listitem> + <simpara> + <constant>SE_UID</constant> - Retourne des UID à la place de numéros + </simpara> + </listitem> + <listitem> + <simpara> + <constant>SE_NOPREFETCH</constant> - Ne pas pré-télécharger les messages trouvés + </simpara> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>search_criteria</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>charset</parameter></term> <listitem> - <simpara> - <constant>SE_NOPREFETCH</constant> - Ne pas pré-télécharger - les messages trouvés - </simpara> + <para> + </para> </listitem> - </itemizedlist> - </para> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau de numéros de messages triés en fonction + des paramètres fournis. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; <para> - Le paramètre <parameter>charset</parameter> a été ajouté en &php; 4.3.3. + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.3</entry> + <entry> + Le paramètre <parameter>charset</parameter> a été ajouté. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> - </refsect1> - </refentry> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -112,4 +174,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-status.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-status.xml diff -u phpdoc-fr/reference/imap/functions/imap-status.xml:1.12 phpdoc-fr/reference/imap/functions/imap-status.xml:1.13 --- phpdoc-fr/reference/imap/functions/imap-status.xml:1.12 Tue Jan 24 18:05:44 2006 +++ phpdoc-fr/reference/imap/functions/imap-status.xml Tue Jan 30 18:40:50 2007 @@ -1,98 +1,131 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.9 Maintainer: didou Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-status"> - <refnamediv> - <refname>imap_status</refname> - <refpurpose> - Retourne les informations de statut sur une boîte aux lettres - autres que la boîte courante - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>object</type><methodname>imap_status</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> - <methodparam><type>int</type><parameter>options</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_status</function> retourne un objet contenant - les informations de statut. Les options valables sont : - <itemizedlist> - <listitem> - <simpara> - <constant>SA_MESSAGES</constant> - met la valeur de - status->messages au nombre de messages dans la boîte aux lettres. - </simpara> - </listitem> - <listitem> - <simpara> - <constant>SA_RECENT</constant> - met la valeur de status->recent - au nombre de messages récents dans la boîte aux lettres. - </simpara> - </listitem> - <listitem> - <simpara> - <constant>SA_UNSEEN</constant> - met la valeur de status->unseen - au nombre de messages non lus dans la boîte aux lettres. - </simpara> - </listitem> - <listitem> - <simpara> - <constant>SA_UIDNEXT</constant> - met la valeur de status->uidnext - à la prochaine valeur d'uid qui sera utilisée. - </simpara> - </listitem> - <listitem> - <simpara> - <constant>SA_UIDVALIDITY</constant> - met la valeur de - status->uidvalidity à une constante, qui change lorsque l'uid de - la boîte aux lettres n'est plus valide. - </simpara> - </listitem> - <listitem> - <simpara> - <constant>SA_ALL</constant> - fixe toutes les valeurs précédentes. - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - status->flags est aussi fixé : c'est un masque de bit qui - peut contenir tous les flags ci-dessus. - </para> - <para> - <example> - <title>Exemple avec <function>imap_status</function></title> - <programlisting role="php"> + +<refentry id="function.imap-status"> + <refnamediv> + <refname>imap_status</refname> + <refpurpose>Retourne les informations de statut sur une boîte aux lettres</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>object</type><methodname>imap_status</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> + <methodparam><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <para> + Retourne les informations de statut sur la boîte aux lettres <parameter>mailbox</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>mailbox</parameter></term> + <listitem> + <para> + Le nom de la boîte aux lettres, voir la documentation de la fonction + <function>imap_open</function> pour plus de détails + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> + <listitem> + <para> + Les drapeaux valides sont : + <itemizedlist> + <listitem> + <simpara> + <constant>SA_MESSAGES</constant> - met la valeur de + status->messages au nombre de messages dans la boîte aux lettres. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>SA_RECENT</constant> - met la valeur de status->recent + au nombre de messages récents dans la boîte aux lettres. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>SA_UNSEEN</constant> - met la valeur de status->unseen + au nombre de messages non lus dans la boîte aux lettres. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>SA_UIDNEXT</constant> - met la valeur de status->uidnext + à la prochaine valeur d'uid qui sera utilisée. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>SA_UIDVALIDITY</constant> - met la valeur de + status->uidvalidity à une constante, qui change lorsque l'uid de + la boîte aux lettres n'est plus valide. + </simpara> + </listitem> + <listitem> + <simpara> + <constant>SA_ALL</constant> - fixe toutes les valeurs précédentes. + </simpara> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Cette fonction retourne un objet contenant les informations sur le + statut. L'objet a les propriétés suivantes : <literal>messages</literal>, + <literal>recent</literal>, <literal>unseen</literal>, + <literal>uidnext</literal>, et <literal>uidvalidity</literal>. + </para> + <para> + <literal>flags</literal> est également défini, qui contient un masque + contenant une des constantes ci-dessus. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_status</function></title> + <programlisting role="php"> <![CDATA[ <?php - -$mbox = imap_open("{imap.example.org}", "utilisateur", "mot_de_passe", OP_HALFOPEN) - or die("can't connect: " . imap_last_error()); +$mbox = imap_open("{imap.example.com}", "username", "password", OP_HALFOPEN) + or die("Connexion impossible : " . imap_last_error()); $status = imap_status($mbox, "{imap.example.org}INBOX", SA_ALL); -if($status) { - echo "Messages: " . $status->messages . "<br />\n"; - echo "Récents: " . $status->recent . "<br />\n"; - echo "Non lus: " . $status->unseen . "<br />\n"; - echo "UIDnext: " . $status->uidnext . "<br />\n"; - echo "UIDvalidité: " . $status->uidvalidity . "<br />\n"; +if ($status) { + echo "Messages : " . $status->messages . "<br />\n"; + echo "Récent : " . $status->recent . "<br />\n"; + echo "Non lu : " . $status->unseen . "<br />\n"; + echo "Prochain UID: " . $status->uidnext . "<br />\n"; + echo "Validité de l'UID:" . $status->uidvalidity . "<br />\n"; } else { - echo "imap_status a échoué : " . imap_last_error() . "\n"; + echo "imap_status a échoué : " . imap_last_error() . "\n"; } imap_close($mbox); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -113,4 +146,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-subscribe.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-subscribe.xml diff -u phpdoc-fr/reference/imap/functions/imap-subscribe.xml:1.8 phpdoc-fr/reference/imap/functions/imap-subscribe.xml:1.9 --- phpdoc-fr/reference/imap/functions/imap-subscribe.xml:1.8 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-subscribe.xml Tue Jan 30 18:40:50 2007 @@ -1,31 +1,56 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-subscribe"> - <refnamediv> - <refname>imap_subscribe</refname> - <refpurpose>Souscrit à une boîte aux lettres</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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> - &return.success; - </para> - <para> - Voir aussi <function>imap_unsubscribe</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-subscribe"> + <refnamediv> + <refname>imap_subscribe</refname> + <refpurpose>Souscrit à une boîte aux lettres</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imap_subscribe</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> + </methodsynopsis> + <para> + Souscrit à une boîte aux lettres. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>mailbox</parameter></term> + <listitem> + <para> + Le nom de la boîte aux lettres, voir la documentation de la fonction + <function>imap_open</function> pour plus de détails + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_unsubscribe</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -46,4 +71,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-thread.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-thread.xml diff -u phpdoc-fr/reference/imap/functions/imap-thread.xml:1.8 phpdoc-fr/reference/imap/functions/imap-thread.xml:1.9 --- phpdoc-fr/reference/imap/functions/imap-thread.xml:1.8 Sun Oct 30 06:39:33 2005 +++ phpdoc-fr/reference/imap/functions/imap-thread.xml Tue Jan 30 18:40:50 2007 @@ -1,51 +1,74 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.6 Maintainer: didou Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-thread"> - <refnamediv> - <refname>imap_thread</refname> - <refpurpose> - Retourne l'arbre des messages organisés par thread - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>imap_thread</methodname> - <methodparam><type>resource</type><parameter>stream_id</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_thread</function> retourne un tableau associatif contenant - un arbre de messages organisés par thread par <literal>REFERENCES</literal> - ou &false; en cas d'erreur. - </para> - <para> - Chaque message dans la boîte aux lettres courante sera représenté par des entrées - sous forme d'arbre dans le tableau résultant : - <itemizedlist> - <listitem><para> - <varname>$thread["XX.num"]</varname> - numéro du message courant - </para></listitem> - <listitem><para> - <varname>$thread["XX.next"]</varname> - </para></listitem> - <listitem><para> - <varname>$thread["XX.branch"]</varname> - </para></listitem> - </itemizedlist> - </para> - <para> - <example> - <title>Exemple avec <function>imap_thread</function></title> - <programlisting role="php"> + +<refentry id='function.imap-thread'> + <refnamediv> + <refname>imap_thread</refname> + <refpurpose>Retourne l'arbre des messages organisés par thread</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>imap_thread</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <para> + Retourne l'arbre des messages organisés par thread. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>options</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + <function>imap_thread</function> retourne un tableau associatif contenant + un arbre de messages organisés par thread par <literal>REFERENCES</literal> + ou &false; en cas d'erreur. + </para> + <para> + Chaque message dans la boîte aux lettres courante sera représenté par des entrées + sous forme d'arbre dans le tableau résultant : + <itemizedlist> + <listitem><para> + <varname>$thread["XX.num"]</varname> - numéro du message courant + </para></listitem> + <listitem><para> + <varname>$thread["XX.next"]</varname> + </para></listitem> + <listitem><para> + <varname>$thread["XX.branch"]</varname> + </para></listitem> + </itemizedlist> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>imap_thread</function></title> + <programlisting role="php"> <![CDATA[ <?php // Ici, nous affichons les threads d'un newsgroup, en HTML -$nntp = imap_open('{news.example.com:119/nntp}un.newsgroup', '', ''); +$nntp = imap_open('{news.example.com:119/nntp}some.newsgroup', '', ''); $threads = imap_thread($nntp); foreach ($threads as $key => $val) { @@ -62,11 +85,11 @@ ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -87,4 +110,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-timeout.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-timeout.xml diff -u phpdoc-fr/reference/imap/functions/imap-timeout.xml:1.6 phpdoc-fr/reference/imap/functions/imap-timeout.xml:1.7 --- phpdoc-fr/reference/imap/functions/imap-timeout.xml:1.6 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-timeout.xml Tue Jan 30 18:40:50 2007 @@ -1,26 +1,23 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: didou Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-timeout"> - <refnamediv> - <refname>imap_timeout</refname> - <refpurpose> - Configure ou retourne le timeout - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>imap_timeout</methodname> - <methodparam><type>int</type><parameter>timeout_type</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>timeout</parameter></methodparam> - </methodsynopsis> - &warn.undocumented.func; - - </refsect1> - </refentry> +<refentry id="function.imap-timeout"> + <refnamediv> + <refname>imap_timeout</refname> + <refpurpose>Configure ou retourne le timeout</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>imap_timeout</methodname> + <methodparam><type>int</type><parameter>timeout_type</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>timeout</parameter></methodparam> + </methodsynopsis> + &warn.undocumented.func; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -41,4 +38,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-uid.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-uid.xml diff -u phpdoc-fr/reference/imap/functions/imap-uid.xml:1.10 phpdoc-fr/reference/imap/functions/imap-uid.xml:1.11 --- phpdoc-fr/reference/imap/functions/imap-uid.xml:1.10 Wed Oct 19 02:16:32 2005 +++ phpdoc-fr/reference/imap/functions/imap-uid.xml Tue Jan 30 18:40:50 2007 @@ -1,41 +1,71 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-uid"> - <refnamediv> - <refname>imap_uid</refname> - <refpurpose> - Retourne l'UID d'un message - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>imap_uid</methodname> - <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>int</type><parameter>msgno</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_uid</function> retourne l'UID pour le message - <parameter>msgno</parameter>. Un UID est un identifant unique - que ne change jamais, alors que le numéro du message dans - la liste des messages peut changer à toute modification - de la boîte aux lettres. C'est la fonction inverse de - <function>imap_msgno</function>. - </para> - <note> - <para> - Cette fonctionnalité n'est pas supportée par les boîtes aux lettres - POP3. - </para> - </note> + +<refentry id="function.imap-uid"> + <refnamediv> + <refname>imap_uid</refname> + <refpurpose>Retourne l'UID d'un message</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>imap_uid</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>int</type><parameter>msg_number</parameter></methodparam> + </methodsynopsis> + <para> + <function>imap_uid</function> retourne l'UID pour le message + <parameter>msgno</parameter>. Un UID est un identifant unique + que ne change jamais, alors que le numéro du message dans + la liste des messages peut changer à toute modification + de la boîte aux lettres. + </para> + <para> + C'est la fonction inverse de <function>imap_msgno</function>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>msg_number</parameter></term> + <listitem> + <para> + Le numéro du message. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + L'UID d'un message donné. + </para> + </refsect1> + <refsect1 role="notes"> + &reftitle.notes; + <note> <para> - Voir aussi - <function>imap_msgno</function>. + Cette fonctionnalité n'est pas supportée par les boîtes aux lettres + POP3. </para> - </refsect1> - </refentry> + </note> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_msgno</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -56,4 +86,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-undelete.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-undelete.xml diff -u phpdoc-fr/reference/imap/functions/imap-undelete.xml:1.9 phpdoc-fr/reference/imap/functions/imap-undelete.xml:1.10 --- phpdoc-fr/reference/imap/functions/imap-undelete.xml:1.9 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-undelete.xml Tue Jan 30 18:40:50 2007 @@ -1,35 +1,66 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.6 Maintainer: didou Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-undelete"> - <refnamediv> - <refname>imap_undelete</refname> - <refpurpose>Enlève la marque d'effacement d'un message</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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> - <methodparam choice="opt"><type>int</type><parameter>flags</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> ou <function>imap_mail_move</function>. - </para> - <para> - &return.success; - </para> - <para> - Voir aussi - <function>imap_delete</function> et - <function>imap_mail_move</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-undelete"> + <refnamediv> + <refname>imap_undelete</refname> + <refpurpose>Enlève la marque d'effacement d'un message</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <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> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> + </methodsynopsis> + <para> + Enlève la marque d'effacement du message + <parameter>msg_number</parameter>, placée avec + <function>imap_delete</function> ou <function>imap_mail_move</function>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>msg_number</parameter></term> + <listitem> + <para> + Le numéro du message + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>flags</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_delete</function></member> + <member><function>imap_mail_move</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -50,4 +81,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml diff -u phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml:1.9 phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml:1.10 --- phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml:1.9 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-unsubscribe.xml Tue Jan 30 18:40:50 2007 @@ -1,31 +1,56 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-unsubscribe"> - <refnamediv> - <refname>imap_unsubscribe</refname> - <refpurpose>Termine la souscription à une boîte aux lettres</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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>. - </para> - <para> - &return.success; - </para> - <para> - Voir aussi <function>imap_subscribe</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-unsubscribe"> + <refnamediv> + <refname>imap_unsubscribe</refname> + <refpurpose>Termine la souscription à une boîte aux lettres</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>imap_unsubscribe</methodname> + <methodparam><type>string</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> + </methodsynopsis> + <para> + Termine la souscription à la boîte aux lettres <parameter>mailbox</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>mailbox</parameter></term> + <listitem> + <para> + Le nom de la boîte aux lettres, voir la documentation de la fonction + <function>imap_open</function> pour plus de détails. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_subscribe</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -46,4 +71,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-utf7-decode.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-utf7-decode.xml diff -u phpdoc-fr/reference/imap/functions/imap-utf7-decode.xml:1.8 phpdoc-fr/reference/imap/functions/imap-utf7-decode.xml:1.9 --- phpdoc-fr/reference/imap/functions/imap-utf7-decode.xml:1.8 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-utf7-decode.xml Tue Jan 30 18:40:50 2007 @@ -1,42 +1,65 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.7 Maintainer: didou Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-utf7-decode"> - <refnamediv> - <refname>imap_utf7_decode</refname> - <refpurpose>Décode une chaîne encodée en UTF-7 modifié</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>imap_utf7_decode</methodname> - <methodparam><type>string</type><parameter>text</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_utf7_decode</function> décode la chaîne UTF-7 - modifié <parameter>text</parameter> en ISO-8859-1. - </para> - <para> - <function>imap_utf7_decode</function> retourne les données - décodées en ISO-8859-1, ou &false; si la chaîne - <parameter>text</parameter> n'est pas au format UTF-7 modifié. - </para> - <para> - Cette fonction sert à encoder les noms de boîtes aux lettres qui - contiennent des caractères internationaux hors de l'espace ASCII. - </para> - <para> - L'encodage UTF-7 modifié est défini dans la <ulink - url="&url.rfc;2060">RFC 2060</ulink>, section 5.1.3 (l'encodage - UTF-7 original est lui défini dans <ulink - url="&url.rfc;1642">RFC1642</ulink>). - </para> - <para> - Voir aussi <function>imap_utf7_encode</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-utf7-decode"> + <refnamediv> + <refname>imap_utf7_decode</refname> + <refpurpose>Décode une chaîne encodée en UTF-7 modifié</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>imap_utf7_decode</methodname> + <methodparam><type>string</type><parameter>text</parameter></methodparam> + </methodsynopsis> + <para> + <function>imap_utf7_decode</function> décode la chaîne UTF-7 + <parameter>text</parameter> en ISO-8859-1. + </para> + <para> + Cette fonction sert à encoder les noms de boîtes aux lettres qui + contiennent des caractères internationaux hors de l'espace ASCII. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>text</parameter></term> + <listitem> + <para> + L'encodage UTF-7 modifié est défini dans la <ulink + url="&url.rfc;2060">RFC 2060</ulink>, section 5.1.3 (l'encodage + UTF-7 original est lui défini dans <ulink + url="&url.rfc;1642">RFC1642</ulink>). + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne une &string; encodée ISO-8859-1 et contenant la même + séquence de caractères que dans le paramètre <parameter>text</parameter>, + ou &false; si <parameter>text</parameter> contient une séquence UTF-7 + modifiée invalide ou si <parameter>text</parameter> contient un caractère + qui ne fait pas partie du jeu de caractères ISO-8859-1. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_utf7_encode</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -57,4 +80,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-utf7-encode.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-utf7-encode.xml diff -u phpdoc-fr/reference/imap/functions/imap-utf7-encode.xml:1.8 phpdoc-fr/reference/imap/functions/imap-utf7-encode.xml:1.9 --- phpdoc-fr/reference/imap/functions/imap-utf7-encode.xml:1.8 Tue Nov 16 21:46:39 2004 +++ phpdoc-fr/reference/imap/functions/imap-utf7-encode.xml Tue Jan 30 18:40:50 2007 @@ -1,38 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.8 Maintainer: didou Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-utf7-encode"> - <refnamediv> - <refname>imap_utf7_encode</refname> - <refpurpose>Convertit une chaîne ISO-8859-1 en texte UTF-7 modifié</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>imap_utf7_encode</methodname> - <methodparam><type>string</type><parameter>data</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_utf7_encode</function> convertit les données - <parameter>data</parameter> en UTF-7 modifié. - Notez que <parameter>data</parameter> doit être encodée en ISO-8859-1. - </para> - <para> - Cette fonction sert à encoder les noms de boîtes aux lettres qui - contiennent des caractères internationaux hors de l'espace ASCII. - </para> - <para> - L'encodage UTF-7 modifié est défini dans la <ulink + +<refentry id="function.imap-utf7-encode"> + <refnamediv> + <refname>imap_utf7_encode</refname> + <refpurpose>Convertit une chaîne ISO-8859-1 en texte UTF-7 modifié</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>imap_utf7_encode</methodname> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + </methodsynopsis> + <para> + Convertit une chaîne <parameter>data</parameter> + ISO-8859-1 en texte UTF-7 modifié. + </para> + <para> + Cette fonction sert à encoder les noms de boîtes aux lettres qui + contiennent des caractères internationaux hors de l'espace ASCII. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>data</parameter></term> + <listitem> + <para> + Une &string; ISO-8859-1. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne les données <parameter>data</parameter> encodées + avec l'encodage UTF-7 modifié tel que défini dans la <ulink url="&url.rfc;2060">RFC 2060</ulink>, section 5.1.3 (l'encodage UTF-7 original est lui défini dans <ulink url="&url.rfc;1642">RFC1642</ulink>). - </para> - <para> - Voir aussi <function>imap_utf7_decode</function>. - </para> - </refsect1> - </refentry> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_utf7_decode</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -53,4 +77,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-utf8.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/imap/functions/imap-utf8.xml diff -u phpdoc-fr/reference/imap/functions/imap-utf8.xml:1.9 phpdoc-fr/reference/imap/functions/imap-utf8.xml:1.10 --- phpdoc-fr/reference/imap/functions/imap-utf8.xml:1.9 Wed Dec 14 15:42:20 2005 +++ phpdoc-fr/reference/imap/functions/imap-utf8.xml Tue Jan 30 18:40:50 2007 @@ -1,32 +1,55 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.6 Maintainer: didou Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> - <refentry id="function.imap-utf8"> - <refnamediv> - <refname>imap_utf8</refname> - <refpurpose> - Convertit du texte au format MIME en UTF8 - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>imap_utf8</methodname> - <methodparam><type>string</type><parameter>mime_encoded_text</parameter></methodparam> - </methodsynopsis> - <para> - <function>imap_utf8</function> convertit le texte - <parameter>mime_encoded_text</parameter> en UTF8. - Les spécifications de MIME et UTF8 sont décrites dans les - <ulink url="&url.rfc;2047">RFC2047</ulink> et - <ulink url="&url.rfc;2044">RFC2044</ulink>. - </para> - <para> - Voyez aussi <function>imap_mime_header_decode</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.imap-utf8"> + <refnamediv> + <refname>imap_utf8</refname> + <refpurpose>Convertit du texte au format MIME en UTF-8</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>imap_utf8</methodname> + <methodparam><type>string</type><parameter>mime_encoded_text</parameter></methodparam> + </methodsynopsis> + <para> + Convertit le texte <parameter>mime_encoded_text</parameter> en UTF-8. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>mime_encoded_text</parameter></term> + <listitem> + <para> + Une &string; encodé MIME. Les spécifications de MIME et UTF8 + sont décrites dans les <ulink url="&url.rfc;2047">RFC2047</ulink> et + <ulink url="&url.rfc;2044">RFC2044</ulink>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne une &string; encodée UTF-8. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_mime_header_decode</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -47,4 +70,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/reference.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/imap/reference.xml diff -u phpdoc-fr/reference/imap/reference.xml:1.15 phpdoc-fr/reference/imap/reference.xml:1.16 --- phpdoc-fr/reference/imap/reference.xml:1.15 Sun Dec 11 20:54:37 2005 +++ phpdoc-fr/reference/imap/reference.xml Tue Jan 30 18:40:50 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.17 Maintainer: didou Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> <!-- Purpose: remote.mail --> <!-- Membership: bundled, external --> <!-- Reviewed: yes --> @@ -12,14 +12,17 @@ <section id="imap.intro"> &reftitle.intro; <para> - Ces fonctions ne sont pas limitées au protocole <acronym>IMAP</acronym>, - malgrès leur nom. La bibliothèque cliente C supporte aussi les méthodes - d'accès à <acronym>NNTP</acronym>, <acronym>POP3</acronym> et aux boîtes - aux lettres locales. + Ces fonctions vous permettent d'utiliser le protocole <acronym>IMAP</acronym>, + mais aussi les protocoles <acronym>NNTP</acronym>, <acronym>POP3</acronym> + et les boîtes aux lettres locales. + </para> + <para> + Cependant, soyez prudent car quelques fonctions IMAP ne fonctionnent pas + correctement avec le protocole POP. </para> </section> - - <section id="imap.requirements"> + + <section id="imap.requirements"> &reftitle.required; <para> Cette extension requiert la bibliothèque C cliente. Téléchargez http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/imap/functions/imap-savebody.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/imap/functions/imap-savebody.xml +++ phpdoc-fr/reference/imap/functions/imap-savebody.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id="function.imap-savebody"> <refnamediv> <refname>imap_savebody</refname> <refpurpose>Sauvegarde une partie spécifique du corps dans un fichier</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>imap_savebody</methodname> <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> <methodparam><type>mixed</type><parameter>file</parameter></methodparam> <methodparam><type>int</type><parameter>msg_number</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>part_number</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> </methodsynopsis> <para> Sauvegarde une partie du corps du message spécifié. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> &imap.imap-stream.description; <varlistentry> <term><parameter>file</parameter></term> <listitem> <para> Le chemin vers le fichier de sauvegarde, sous la forme d'une &string; ou un descripteur de fichier valide retourné par la fonction <function>fopen</function>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>msg_number</parameter></term> <listitem> <para> Le numéro du message </para> </listitem> </varlistentry> <varlistentry> <term><parameter>part_number</parameter></term> <listitem> <para> Le numéro de la section. C'est une &string; d'entiers, délimités par une virgule qui correspondent à l'index dans la liste des sections du corps, tel que prévu par la spécification IMAP4. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>options</parameter></term> <listitem> <para> Un masque qui contient une ou plusieurs des valeurs suivantes : <itemizedlist> <listitem> <simpara> <constant>FT_UID</constant> - Le numéro <parameter>msg_number</parameter> est un UID </simpara> </listitem> <listitem> <simpara> <constant>FT_PEEK</constant> - Ne pas définir le drapeau \Seen s'il n'est pas déjà défini </simpara> </listitem> <listitem> <simpara> <constant>FT_INTERNAL</constant> - La &string; retournée est dans un format interne, qui ne correspondant pas à CRLF. </simpara> </listitem> </itemizedlist> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>imap_fetchbody</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->