cvs: peardoc /fr/package/mail/mail-rfc822 mail-rfc822.xml parseaddresslist.xml
| From: | Christophe Gesch� | Date: | Sat, 24 Apr 2004 22:11:41 +0000 |
| Subject: | cvs: peardoc /fr/package/mail/mail-rfc822 mail-rfc822.xml parseaddresslist.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-3709@lists.php.net to get a copy of this message | ||
moosh Sat Apr 24 18:11:41 2004 EDT
Added files:
/peardoc/fr/package/mail/mail-rfc822 mail-rfc822.xml
parseaddresslist.xml
Log:
- first translation
http://cvs.php.net/co.php/peardoc/fr/package/mail/mail-rfc822/mail-rfc822.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-rfc822/mail-rfc822.xml +++ peardoc/fr/package/mail/mail-rfc822/mail-rfc822.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.3 $ --> <!-- Translation comment : I need beter translation for "backend" --> <refentry id="package.mail.mail.factory"> <refnamediv> <refname>Mail::factory()</refname> <refpurpose>crée une instance du mailer</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail.php'; </funcsynopsisinfo> <funcprototype> <funcdef>objet <function>&factory</function></funcdef> <paramdef>chaîne <parameter>$backend</parameter></paramdef> <paramdef> tableau <parameter><optional>$param = array()</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail.factory.desc"> &title.desc; <para> Crée une instance d'une classe du backend de mailer spécifique. </para> </refsect1> <refsect1 id="package.mail.mail.factory.parameter"> &title.param; <para> <itemizedlist> <listitem> <para> <parameter>chaîne $backend</parameter> - le nom du backend <parameter>"mail"</parameter>,<parameter>"smtp"</parameter>, <parameter>"sendmail"</parameter> </para> </listitem> <listitem> <para> <parameter>tableau $param</parameter> - un tableau contenant les paramètres spécifique au backend choisi. </para> <para> Liste of paramètres pour le backend <itemizedlist> <listitem> <para> <parameter>mail</parameter> <itemizedlist> <listitem> <para> pas d'option supplémentaires </para> </listitem> </itemizedlist> </para> </listitem> <listitem> <para> <parameter>sendmail</parameter> <itemizedlist> <listitem> <para> <parameter>$param["sendmail_path"]</parameter> - L'emplacement du programme sendmail sur votre système fichier. Par défaut <parameter>/usr/bin/sendmail</parameter> </para> </listitem> <listitem> <para> <parameter>$param["sendmail_args"]</parameter> - Paramètre supplémentaires à donner à l'appel du programme sendmail. </para> </listitem> </itemizedlist> </para> </listitem> <listitem> <para> <parameter>smtp</parameter> <itemizedlist> <listitem> <para> <parameter>$param["host"]</parameter> - Le serveur auquel on doit se connecter. Par défault c'est <parameter>localhost</parameter> </para> </listitem> <listitem> <para> <parameter>$param["port"]</parameter> - Le port de connection. Par default <parameter>25</parameter> </para> </listitem> <listitem> <para> <parameter>$param["auth"]</parameter> - Booléen pour exprimer s'il faut ou non une authentication SMTP. Par défaut : &false; </para> </listitem> <listitem> <para> <parameter>$param["username"]</parameter> - le nom d'utilisateur pour une connection avec authentication SMTP. </para> </listitem> <listitem> <para> <parameter>$param["password"]</parameter> - le mot de passe pour une connection avec authentication SMTP. </para> </listitem> </itemizedlist> </para> </listitem> </itemizedlist> </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="package.mail.mail.factory.return"> &title.returns; <para> <parameter>object</parameter> - une nouvelle instance de &class.mail; ou en cas d'echec, un objet &class.pear-error; </para> </refsect1> <refsect1 id="package.mail.mail.factory.throws"> &title.throws; <para> <table> <title>&title.throws.errortable;</title> <tgroup cols="4"> <thead> <row> <entry>code</entry> <entry>message</entry> <entry>sens du message</entry> <entry>cause</entry> <entry>solution</entry> </row> </thead> <tbody> <row> <entry>&null;</entry> <entry> <quote>Unable to find class for driver <parameter>xxx</parameter></quote> </entry> <entry> <quote>Impossible de trouver une classe pour le driver <parameter>xxx</parameter></quote> </entry> <entry> La classe du backend de mail est introuvable. </entry> <entry> Verifiez le paramètre <parameter>$backend</parameter>, si il est correct réinstallez et/ou mettez le pakage Mail à jour. </entry> </row> </tbody> </tgroup> </table> </para> </refsect1> <refsect1 id="package.mail.mail.factory.note"> &title.note; ¬e.shouldstatic; </refsect1> <refsect1 id="package.mail.mail.factory.see"> &title.see; <para> <link linkend="package.mail.mail.intro.backend"> <quote>Introduction</quote> </link> </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 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 --> http://cvs.php.net/co.php/peardoc/fr/package/mail/mail-rfc822/parseaddresslist.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-rfc822/parseaddresslist.xml +++ peardoc/fr/package/mail/mail-rfc822/parseaddresslist.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.4 $ --> <refentry id="package.mail.mail-rfc822.parseaddresslist"> <refnamediv> <refname>Mail_RFC822::parseAddressList()</refname> <refpurpose>Décompose les adresses Emails</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail/RFC822.php'; </funcsynopsisinfo> <funcprototype> <funcdef>array <function>parseAddressList</function></funcdef> <paramdef> string <parameter><optional>$address = ''</optional></parameter> </paramdef> <paramdef> string <parameter><optional>$defaultDomain = 'localhost'</optional> </parameter> </paramdef> <paramdef> boolean <parameter><optional>$nestGroups = &false;</optional></parameter> </paramdef> <paramdef> boolean <parameter><optional>$validate = &false;</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail-rfc822.parseaddresslist.desc"> &title.desc; <para> Décompose les adresses données en leurs parties </para> </refsect1> <refsect1 id="package.mail.mail-rfc822.parseaddresslist.parameter"> &title.param; <para> <itemizedlist> <listitem> <para> <parameter>chaine $address</parameter> les adresses à valider. </para> </listitem> <listitem> <para> <parameter>chaine $defaultDomain</parameter> - le domaine par défaut si une adresse donnée sans. </para> </listitem> <listitem> <para> <parameter>booléen $nestGroups</parameter> - indique si une structure avec les groupes imbriqués doit être retourneé pour une visualisation plus aisée. </para> </listitem> <listitem> <para> <parameter>booléen $validate</parameter> - whether to validate atoms. Turn this off if you need to run addresses through before encoding the personal names, for instance. </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="package.mail.mail-rfc822.parseaddresslist.return"> &title.returns; <para> <parameter>tableau</parameter> - un tableau imbriqué d'objets. </para> <para> Si <parameter>$nestGroups</parameter> est à &false;, vous pouvez passer au paragraphe suivant. </para> <para> Chaque entrée du tableau contient un objet par groupe Chaque objet à deux attributs: <simplelist> <member> <parameter>groupname</parameter> - le nom du groupe </member> <member> <parameter>addresses</parameter> - un tableau de toutes les adresses du groupe </member> </simplelist> </para> <para> Le tableau d'<parameter>adresses</parameter> consiste en un tableau d'objets anonymes pour chaque adresse. Ces objets comprennent les attributs suivants: <simplelist> <member> <parameter>personal</parameter> - le nom du propriétaire de l'adresse </member> <member> <parameter>comment</parameter> - un tableau, une entree pour chaque commentaire par adresse </member> <member> <parameter>mailbox</parameter> - le nom de la boite mail, la partie devant le @ </member> <member> <parameter>host</parameter> - le nom du serveur, parte après @ </member> </simplelist> </para> </refsect1> <refsect1 id="package.mail.mail-rfc822.parseaddresslist.throws"> &title.throws; <para> <table> <title>&title.throws.errortable;</title> <tgroup cols="4"> <thead> <row> <entry>code</entry> <entry>message</entry> <entry>message</entry> <entry>cause</entry> <entry>solution</entry> </row> </thead> <tbody> <row> <entry>&null;</entry> <entry> every </entry> <entry> The given address string is not <ulink url="&url.rfc;822">RFC822</ulink> compliant </entry> <entry> l'adresse fournie n'est pas conforme <ulink url="&url.rfc;822">RFC822</ulink> </entry> <entry> Le code d'erreur contient la description de l'erreur. </entry> </row> </tbody> </tgroup> </table> </para> </refsect1> <refsect1 id="package.mail.mail-rfc822.parseaddresslist.note"> &title.note; ¬e.canstatic; <warning> <para> Cette classe ne vérifie que la chaine. L'existence de l'adresse n'est pas vérifiée. </para> </warning> </refsect1> <refsect1 id="package.mail.mail-rfc822.parseaddresslist.example"> &title.example; <para> <example> <title>Extrait des adresses</title> <programlisting role="php"> <![CDATA[ <?php $adresse = 'Mon groupe: "Richard" <richard@localhost>;, ted@exemple.com (un commentaire)'; $adresses = Mail_RFC822::parseAddressList($adresse, 'phpguru.org', TRUE); var_export($adresses); ?> ]]> </programlisting> </example> </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 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 -->
http://cvs.php.net/co.php/peardoc/fr/package/mail/mail-rfc822/mail-rfc822.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-rfc822/mail-rfc822.xml +++ peardoc/fr/package/mail/mail-rfc822/mail-rfc822.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.3 $ --> <!-- Translation comment : I need beter translation for "backend" --> <refentry id="package.mail.mail.factory"> <refnamediv> <refname>Mail::factory()</refname> <refpurpose>crée une instance du mailer</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail.php'; </funcsynopsisinfo> <funcprototype> <funcdef>objet <function>&factory</function></funcdef> <paramdef>chaîne <parameter>$backend</parameter></paramdef> <paramdef> tableau <parameter><optional>$param = array()</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail.factory.desc"> &title.desc; <para> Crée une instance d'une classe du backend de mailer spécifique. </para> </refsect1> <refsect1 id="package.mail.mail.factory.parameter"> &title.param; <para> <itemizedlist> <listitem> <para> <parameter>chaîne $backend</parameter> - le nom du backend <parameter>"mail"</parameter>,<parameter>"smtp"</parameter>, <parameter>"sendmail"</parameter> </para> </listitem> <listitem> <para> <parameter>tableau $param</parameter> - un tableau contenant les paramètres spécifique au backend choisi. </para> <para> Liste of paramètres pour le backend <itemizedlist> <listitem> <para> <parameter>mail</parameter> <itemizedlist> <listitem> <para> pas d'option supplémentaires </para> </listitem> </itemizedlist> </para> </listitem> <listitem> <para> <parameter>sendmail</parameter> <itemizedlist> <listitem> <para> <parameter>$param["sendmail_path"]</parameter> - L'emplacement du programme sendmail sur votre système fichier. Par défaut <parameter>/usr/bin/sendmail</parameter> </para> </listitem> <listitem> <para> <parameter>$param["sendmail_args"]</parameter> - Paramètre supplémentaires à donner à l'appel du programme sendmail. </para> </listitem> </itemizedlist> </para> </listitem> <listitem> <para> <parameter>smtp</parameter> <itemizedlist> <listitem> <para> <parameter>$param["host"]</parameter> - Le serveur auquel on doit se connecter. Par défault c'est <parameter>localhost</parameter> </para> </listitem> <listitem> <para> <parameter>$param["port"]</parameter> - Le port de connection. Par default <parameter>25</parameter> </para> </listitem> <listitem> <para> <parameter>$param["auth"]</parameter> - Booléen pour exprimer s'il faut ou non une authentication SMTP. Par défaut : &false; </para> </listitem> <listitem> <para> <parameter>$param["username"]</parameter> - le nom d'utilisateur pour une connection avec authentication SMTP. </para> </listitem> <listitem> <para> <parameter>$param["password"]</parameter> - le mot de passe pour une connection avec authentication SMTP. </para> </listitem> </itemizedlist> </para> </listitem> </itemizedlist> </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="package.mail.mail.factory.return"> &title.returns; <para> <parameter>object</parameter> - une nouvelle instance de &class.mail; ou en cas d'echec, un objet &class.pear-error; </para> </refsect1> <refsect1 id="package.mail.mail.factory.throws"> &title.throws; <para> <table> <title>&title.throws.errortable;</title> <tgroup cols="4"> <thead> <row> <entry>code</entry> <entry>message</entry> <entry>sens du message</entry> <entry>cause</entry> <entry>solution</entry> </row> </thead> <tbody> <row> <entry>&null;</entry> <entry> <quote>Unable to find class for driver <parameter>xxx</parameter></quote> </entry> <entry> <quote>Impossible de trouver une classe pour le driver <parameter>xxx</parameter></quote> </entry> <entry> La classe du backend de mail est introuvable. </entry> <entry> Verifiez le paramètre <parameter>$backend</parameter>, si il est correct réinstallez et/ou mettez le pakage Mail à jour. </entry> </row> </tbody> </tgroup> </table> </para> </refsect1> <refsect1 id="package.mail.mail.factory.note"> &title.note; ¬e.shouldstatic; </refsect1> <refsect1 id="package.mail.mail.factory.see"> &title.see; <para> <link linkend="package.mail.mail.intro.backend"> <quote>Introduction</quote> </link> </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 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 --> http://cvs.php.net/co.php/peardoc/fr/package/mail/mail-rfc822/parseaddresslist.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-rfc822/parseaddresslist.xml +++ peardoc/fr/package/mail/mail-rfc822/parseaddresslist.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.4 $ --> <refentry id="package.mail.mail-rfc822.parseaddresslist"> <refnamediv> <refname>Mail_RFC822::parseAddressList()</refname> <refpurpose>Décompose les adresses Emails</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail/RFC822.php'; </funcsynopsisinfo> <funcprototype> <funcdef>array <function>parseAddressList</function></funcdef> <paramdef> string <parameter><optional>$address = ''</optional></parameter> </paramdef> <paramdef> string <parameter><optional>$defaultDomain = 'localhost'</optional> </parameter> </paramdef> <paramdef> boolean <parameter><optional>$nestGroups = &false;</optional></parameter> </paramdef> <paramdef> boolean <parameter><optional>$validate = &false;</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail-rfc822.parseaddresslist.desc"> &title.desc; <para> Décompose les adresses données en leurs parties </para> </refsect1> <refsect1 id="package.mail.mail-rfc822.parseaddresslist.parameter"> &title.param; <para> <itemizedlist> <listitem> <para> <parameter>chaine $address</parameter> les adresses à valider. </para> </listitem> <listitem> <para> <parameter>chaine $defaultDomain</parameter> - le domaine par défaut si une adresse donnée sans. </para> </listitem> <listitem> <para> <parameter>booléen $nestGroups</parameter> - indique si une structure avec les groupes imbriqués doit être retourneé pour une visualisation plus aisée. </para> </listitem> <listitem> <para> <parameter>booléen $validate</parameter> - whether to validate atoms. Turn this off if you need to run addresses through before encoding the personal names, for instance. </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="package.mail.mail-rfc822.parseaddresslist.return"> &title.returns; <para> <parameter>tableau</parameter> - un tableau imbriqué d'objets. </para> <para> Si <parameter>$nestGroups</parameter> est à &false;, vous pouvez passer au paragraphe suivant. </para> <para> Chaque entrée du tableau contient un objet par groupe Chaque objet à deux attributs: <simplelist> <member> <parameter>groupname</parameter> - le nom du groupe </member> <member> <parameter>addresses</parameter> - un tableau de toutes les adresses du groupe </member> </simplelist> </para> <para> Le tableau d'<parameter>adresses</parameter> consiste en un tableau d'objets anonymes pour chaque adresse. Ces objets comprennent les attributs suivants: <simplelist> <member> <parameter>personal</parameter> - le nom du propriétaire de l'adresse </member> <member> <parameter>comment</parameter> - un tableau, une entree pour chaque commentaire par adresse </member> <member> <parameter>mailbox</parameter> - le nom de la boite mail, la partie devant le @ </member> <member> <parameter>host</parameter> - le nom du serveur, parte après @ </member> </simplelist> </para> </refsect1> <refsect1 id="package.mail.mail-rfc822.parseaddresslist.throws"> &title.throws; <para> <table> <title>&title.throws.errortable;</title> <tgroup cols="4"> <thead> <row> <entry>code</entry> <entry>message</entry> <entry>message</entry> <entry>cause</entry> <entry>solution</entry> </row> </thead> <tbody> <row> <entry>&null;</entry> <entry> every </entry> <entry> The given address string is not <ulink url="&url.rfc;822">RFC822</ulink> compliant </entry> <entry> l'adresse fournie n'est pas conforme <ulink url="&url.rfc;822">RFC822</ulink> </entry> <entry> Le code d'erreur contient la description de l'erreur. </entry> </row> </tbody> </tgroup> </table> </para> </refsect1> <refsect1 id="package.mail.mail-rfc822.parseaddresslist.note"> &title.note; ¬e.canstatic; <warning> <para> Cette classe ne vérifie que la chaine. L'existence de l'adresse n'est pas vérifiée. </para> </warning> </refsect1> <refsect1 id="package.mail.mail-rfc822.parseaddresslist.example"> &title.example; <para> <example> <title>Extrait des adresses</title> <programlisting role="php"> <![CDATA[ <?php $adresse = 'Mon groupe: "Richard" <richard@localhost>;, ted@exemple.com (un commentaire)'; $adresses = Mail_RFC822::parseAddressList($adresse, 'phpguru.org', TRUE); var_export($adresses); ?> ]]> </programlisting> </example> </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 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 -->