cvs: peardoc /fr/package/mail/mail-queue/mail-queue deletemail.xml get.xml put.xml sendmail.xml sendmailbyid.xml sendmailsinqueue.xml tutorial.xml
| From: | Christophe Gesch� | Date: | Sat, 24 Apr 2004 12:01:52 +0000 |
| Subject: | cvs: peardoc /fr/package/mail/mail-queue/mail-queue deletemail.xml get.xml put.xml sendmail.xml sendmailbyid.xml sendmailsinqueue.xml tutorial.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-3703@lists.php.net to get a copy of this message | ||
moosh Sat Apr 24 08:01:52 2004 EDT
Added files:
/peardoc/fr/package/mail/mail-queue/mail-queue deletemail.xml
get.xml put.xml
sendmailbyid.xml
sendmailsinqueue.xml
sendmail.xml
tutorial.xml
Log:
- first translation
- ident
http://cvs.php.net/co.php/peardoc/fr/package/mail/mail-queue/mail-queue/deletemail.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-queue/mail-queue/deletemail.xml +++ peardoc/fr/package/mail/mail-queue/mail-queue/deletemail.xml <!-- $Revision$ --> <!-- $EN-Revision: 1.2 $ --> <!-- Translation comment : --> <refentry id="package.mail.mail-queue.mail-queue.deletemail"> <refnamediv> <refname><function>Mail_Queue::deleteMail</function></refname> <refpurpose>Supprime un email de la file.</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail/Queue.php'; </funcsynopsisinfo> <funcprototype> <funcdef> booléen <function>Mail_Queue::deleteMail</function> </funcdef> <paramdef> entier <parameter>$id</parameter> </paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail-queue.mail-queue.deletemail.desc"> &title.desc; <para> Supprime un email de la file selon son identifiant. </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.deletemail.param"> &title.param; <para> <variablelist> <varlistentry> <term> &type.int; <parameter>$id</parameter> </term> <listitem> <para> identifiant de l'email. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.deletemail.throws"> &title.throws; <para> <emphasis>throws</emphasis> no exceptions thrown </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.deletemail.note"> &title.note; ¬e.notstatic; </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-queue/mail-queue/get.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-queue/mail-queue/get.xml +++ peardoc/fr/package/mail/mail-queue/mail-queue/get.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.3 $ --> <!-- Translation comment : --> <refentry id="package.mail.mail-queue.mail-queue.get"> <refnamediv> <refname><function>Mail_Queue::get</function></refname> <refpurpose>Récupère le mail suivant dans la file.</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail/Queue.php'; </funcsynopsisinfo> <funcprototype> <funcdef>objet <function>Mail_Queue_Container::get</function></funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail-queue.mail-queue.get.desc"> &title.desc; <para> Récupère le mail suivant dans la file. Les emails sont préchargés dans un buffer en mémoire pour accélérer le prpcessus. Depuis <classname>Mail_Queue</classname> v.1.1, pour préserver la mémoire, la méthode <function>preload</function> ne précharge plus TOUS les mails mais une partie d'entre-eux. Le buffer s'auto-gère. Quand il est vide, il est automatiquement re-rempli. Vous pouvez fixer la taille du buffeur avec la méthode <function>setBufferSize</function>.</para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.get.returns"> &title.returns; <para> <emphasis>retourne</emphasis> un objet Mail_Queue_Body </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.get.throws"> &title.throws; <para> <emphasis>throws</emphasis> no exceptions thrown </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.get.note"> &title.note; ¬e.notstatic; </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-queue/mail-queue/put.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-queue/mail-queue/put.xml +++ peardoc/fr/package/mail/mail-queue/mail-queue/put.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.1 $ --> <!-- Translation comment : --> <refentry id="package.mail.mail-queue.mail-queue.put"> <refnamediv> <refname><function>Mail_Queue::put</function></refname> <refpurpose>Place un nouveau message dans la file.</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail/Queue.php'; </funcsynopsisinfo> <funcprototype> <funcdef>booléen <function>Mail_Queue::put</function></funcdef> <paramdef>chaîne <parameter>$expediteur</parameter></paramdef> <paramdef>chaîne <parameter>$destinataire</parameter></paramdef> <paramdef>tableau <parameter>$entete</parameter></paramdef> <paramdef>tableau <parameter>$corp</parameter></paramdef> <paramdef>entier <parameter> <optional>$sec_to_send = 0</optional></parameter></paramdef> <paramdef>booléen <parameter> <optional>$supprimer_apres_envoi = &true;</optional></parameter></paramdef> <paramdef>entier <parameter> <optional>$id_user = MAILQUEUE_SYSTEM</optional></parameter></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail-queue.mail-queue.put.desc"> &title.desc; <para> Ajoute un nouveau mail dans la file d'attente d'envoi. </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.put.param"> &title.param; <para> <variablelist> <varlistentry> <term> &type.string; <parameter>$expediteur</parameter> </term> <listitem> <para> Adresse e-mail de l'expéditeur. </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.string; <parameter>$destinataire</parameter> </term> <listitem> <para> Adresse e-mail du destinataire. </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.array; <parameter>$entetes</parameter> </term> <listitem> <para> Tableau des entêtes de l'email retourné par Mail_Mime::headers(). </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.array; <parameter>$corp</parameter> </term> <listitem> <para> Tableau de corps de l'email retourné par Mail_Mime::get(). </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.mixed; <parameter>$sec_to_send</parameter> </term> <listitem> <para> Optionnel - Delai en seconds avant tentative d'envoi. </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.mixed; <parameter>$supprimer_apres_envoi</parameter> </term> <listitem> <para> Optionnel - Si vrai, l'email est supprimé après envoi. </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.int; <parameter>$id_user</parameter> </term> <listitem> <para> Optionnel - ID user. Placé dans la file d'attente et lisible dans le corps du courrier avec getIdUser() par la suite. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.put.returns"> &title.returns; <para> <emphasis>retourne</emphasis> True en ca se réussite </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.put.throws"> &title.throws; <para> <emphasis>throws</emphasis> no exceptions thrown </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.put.note"> &title.note; ¬e.notstatic; </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-queue/mail-queue/sendmailbyid.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-queue/mail-queue/sendmailbyid.xml +++ peardoc/fr/package/mail/mail-queue/mail-queue/sendmailbyid.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.2 $ --> <refentry id="package.mail.mail-queue.mail-queue.sendmailbyid"> <refnamediv> <refname> <function>Mail_Queue::sendMailById</function> </refname> <refpurpose> Envoyer un mail bien précis de la file </refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail/Queue.php'; </funcsynopsisinfo> <funcprototype> <funcdef> booléen <function>Mail_Queue::sendMailById</function> </funcdef> <paramdef> entier <parameter>$id</parameter> </paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailbyid.desc"> &title.desc; <para> Envoie un courrier simple de la file d'attente identifié par $id. Note : Il ne sera pas supprimé automatiquement de la file d'attente après la livraison ! </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailbyid.param"> &title.param; <para> <variablelist> <varlistentry> <term> &type.int; <parameter>$id</parameter> </term> <listitem> <para> Identifieur du mail </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailbyid.returns"> &title.returns; <para> <emphasis>retourne</emphasis> Vrai en cas de succès. Faux en cas d'echec. </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailbyid.throws"> &title.throws; <para> <emphasis>throws</emphasis> no exceptions thrown </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailbyid.note"> &title.note; ¬e.notstatic; </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-queue/mail-queue/sendmailsinqueue.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-queue/mail-queue/sendmailsinqueue.xml +++ peardoc/fr/package/mail/mail-queue/mail-queue/sendmailsinqueue.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.1 $ --> <!-- Translation comment : --> <refentry id="package.mail.mail-queue.mail-queue.sendmailsinqueue"> <refnamediv> <refname> <function>Mail_Queue::sendMailsInQueue</function> </refname> <refpurpose>Envoie des email de la file d'attente.</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail/Queue.php'; </funcsynopsisinfo> <funcprototype> <funcdef>mixed <function>Mail_Queue::sendMailsInQueue</function></funcdef> <paramdef>integer <parameter> <optional>$limite = MAILQUEUE_ALL</optional></parameter></paramdef> <paramdef>integer <parameter> <optional>$decalage = MAILQUEUE_START</optional></parameter></paramdef> <paramdef>integer <parameter> <optional>$tentative = MAILQUEUE_TRY</optional></parameter></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailsinqueue.desc"> &title.desc; <para>Procède a l'envoi des courriers présents dans la file d'attente.</para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailsinqueue.param"> &title.param; <para> <variablelist> <varlistentry> <term> &type.int; <parameter>$limite</parameter> </term> <listitem> <para> Optionnel - Quantité maximum de mails à envoyer. </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.int; <parameter>$decalage</parameter> </term> <listitem> <para> Optionnel - ignore les $decalage premiers mails de la file d'attente. </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.int; <parameter>$tentative</parameter> </term> <listitem> <para> Optionnel - nombre d'essais avant de remettre le mail dans la file pour une tentative ultérieure. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailsinqueue.returns"> &title.returns; <para> <emphasis>retourne</emphasis> Vrai en cas de réussite. Un objet Mail_Queue_Error en cas d'echec. </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailsinqueue.throws"> &title.throws; <para> <emphasis>throws</emphasis> no exceptions thrown </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailsinqueue.note"> &title.note; ¬e.notstatic; </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-queue/mail-queue/sendmail.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-queue/mail-queue/sendmail.xml +++ peardoc/fr/package/mail/mail-queue/mail-queue/sendmail.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.3 $ --> <refentry id="package.mail.mail-queue.mail-queue.sendmail"> <refnamediv> <refname><function>Mail_Queue::sendMail</function></refname> <refpurpose>Procède à l'envoi des objets mails renvoyés par Mail_Queue::get()</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail/Queue.php'; </funcsynopsisinfo> <funcprototype> <funcdef>mixed <function>Mail_Queue::sendMail</function></funcdef> <paramdef>object MailBody <parameter>$mail</parameter></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail-queue.mail-queue.sendmail.desc"> &title.desc; <para>Procède à l'envoi des objets mails renvoyés par Mail_Queue::get().</para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmail.param"> &title.param; <para> <variablelist> <varlistentry> <term> &type.object; MailBody <parameter>$mail</parameter> </term> <listitem> <para> Objet Mail. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmail.returns"> &title.returns; <para> <emphasis>retourne</emphasis> En cas de réussite, vrai. En cas d'echec une erreur de la classe pear. </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmail.throws"> &title.throws; <para> <emphasis>throws</emphasis> no exceptions thrown </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmail.note"> &title.note; ¬e.notstatic; </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-queue/mail-queue/tutorial.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-queue/mail-queue/tutorial.xml +++ peardoc/fr/package/mail/mail-queue/mail-queue/tutorial.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.3 $ --> <!-- translation comment: todo :ident, trans varnames of sample --> <refentry id="package.mail.mail-queue.mail-queue.tutorial"> <refnamediv> <refname>Tutorial</refname> <refpurpose>Un tutorial pour Mail_Queue</refpurpose> </refnamediv> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part1"> <title>Utilisation de Mail_Queue avec un exemple simple</title> <para> Nous utilisons pour cet exemple le db-container et une base de donnée mysql. Vous devez créer quelques tables dans cette base de donnée pour stocker les messages : </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part2"> <title /> <para> <example> <title>mysql.sql</title> <programlisting role="sql"> <![CDATA[ # # `mail_queue` # CREATE TABLE mail_queue ( id bigint(20) NOT NULL default '0', create_time datetime NOT NULL default '0000-00-00 00:00:00', time_to_send datetime NOT NULL default '0000-00-00 00:00:00', sent_time datetime default NULL, id_user bigint(20) NOT NULL default '0', ip varchar(20) NOT NULL default 'unknown', sender varchar(50) NOT NULL default '', recipient varchar(50) NOT NULL default '', headers text NOT NULL, body longtext NOT NULL, try_sent tinyint(4) NOT NULL default '0', delete_after_send tinyint(1) NOT NULL default '1', PRIMARY KEY (id), KEY id (id), KEY time_to_send (time_to_send), KEY id_user (id_user) ); # # `mail_queue_seq` # CREATE TABLE mail_queue_seq ( id int(10) unsigned NOT NULL auto_increment, PRIMARY KEY (id) ); # # Data for `mail_queue_seq` # INSERT INTO mail_queue_seq (id) VALUES (1); ]]> </programlisting> </example> </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part3"> <title /> <para> Premièrement, il faut définir certaines options. Comme vous avez besoin d'eux deux fois (une fois pour ajouter des messages, une fois pour envoyer les messages), il est toujours bon de les ajouter à un fichier de configuration. Nous l'appelerons config.php. </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part4"> <title /> <example> <title>config.php</title> <programlisting role="php"> <![CDATA[ <?php require_once "Mail/Queue.php"; // Options pour stocker les messages // type is the container used, currently there are db and mdb available $db_options['type'] = 'db'; // the others are the options for the used container // here are some for db $db_options['dsn'] = 'mysql://user:password@host/database'; $db_options['mail_table'] = 'mail_queue'; // Voici les options pour envoyer les messages eux-mêmes // ce sont les options requises pour la classe mail, // particulièrement utilisé pour Mail::factory() $mail_options['driver'] = 'smtp'; $mail_options['host'] = 'votre_serveur__smtp.tld'; $mail_options['port'] = 25; $mail_options['auth'] = false; $mail_options['username'] = ''; $mail_options['password'] = ''; ?> ]]> </programlisting> </example> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part5"> <title /> <para> Voilà la configuration faite, passons à l'utilisation. Premièrement il faudra construire un message et l'ajouter à la file: </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part6"> <title /> <example> <title>add_message.php</title> <programlisting role="php"> <![CDATA[ <?php include './config.php'; /* we use the db_options and mail_options here */ $mail_queue =& new Mail_Queue($db_options, $mail_options); $from = 'user@server.com'; $destinataire = "user2@server.com"; $message = 'Hi! This is test message!! :)'; $entetes = array( 'From' => $from, 'To' => $destinataire, 'Subject' => "Message de test" ); /* we use Mail_mime() to construct a valid mail */ $mime =& new Mail_mime(); $mime->setTXTBody($message); $corps = $mime->get(); $entetes = $mime->headers($entetes); /* Placer le message dans la file */ $mail_queue->put( $from, $destinataire, $entetes, $corps ); ?> ]]> </programlisting> </example> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part7"> <title /> <para> Ok, là nous avons utilisé la voie simple pour ajouter un message... Il y a des options plus avancées, consultez la documentation des fonctions d'ajout pour cela. Maintenant nous devons envoyer des messages. C'est la plupart du temp fait par un cron qui execute régulièrement un script pour envoyer les messages. Et maintenant ce petit script d'exemple : </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part8"> <title /> <example> <title>send_messages.php</title> <programlisting role="php"> <![CDATA[ <?php include './config.php'; /* Combien de courrier pourrons-nous envoyer chaque appel du script */ $max_amount_mails = 50; /* Nous utilisons à nouveau db_options et mail_options de la config */ $mail_queue =& new Mail_Queue($db_options, $mail_options); /* Envoi effectif des messages */ $mail_queue->sendMailsInQueue($max_amount_mails); ?> ]]> </programlisting> </example> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part9"> <title /> <para> Voilà c'est fait. Maintenant executez le script régulièrement et ajoutez vos mails à la file . </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part10"> <title /> <para> Depuis <classname>Mail_Queue</classname> v.1.1, la méthode <function>preload</function> peut ne plus précharger TOUS LES courriers dans la mémoire, mais juste quelques uns à la fois. Quand le buffer est vide, il est automatiquement re-rempli. Vous pouvez fixer la taille du buffer par l'intermédiaire de la nouvelle méthode <function>setBufferSize</function>. </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part11"> <title /> <para> Vous pouvez aussi voyer les emails stockés un par un. Voici un petit exemple pour illustrer cela : </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part12"> <title /> <example> <title>send_messages_one_by_one.php</title> <programlisting role="php"> <![CDATA[ <?php // fixe la taille du tampon interne en fonction // des ressources mémoire disponible sur la machine // Le nombre indique la quantité maximum de mail qu'on // peut placer dans la file. $mail_queue->setBufferSize(20); //loop through the stored emails and send them // Boucler sur le lot de mail et les envoyer while ($mail = $mail_queue->get()) { $result = $mail_queue->sendMail($mail); } ?> ]]> </programlisting> </example> </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-executeMultiple-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-queue/mail-queue/deletemail.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-queue/mail-queue/deletemail.xml +++ peardoc/fr/package/mail/mail-queue/mail-queue/deletemail.xml <!-- $Revision$ --> <!-- $EN-Revision: 1.2 $ --> <!-- Translation comment : --> <refentry id="package.mail.mail-queue.mail-queue.deletemail"> <refnamediv> <refname><function>Mail_Queue::deleteMail</function></refname> <refpurpose>Supprime un email de la file.</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail/Queue.php'; </funcsynopsisinfo> <funcprototype> <funcdef> booléen <function>Mail_Queue::deleteMail</function> </funcdef> <paramdef> entier <parameter>$id</parameter> </paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail-queue.mail-queue.deletemail.desc"> &title.desc; <para> Supprime un email de la file selon son identifiant. </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.deletemail.param"> &title.param; <para> <variablelist> <varlistentry> <term> &type.int; <parameter>$id</parameter> </term> <listitem> <para> identifiant de l'email. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.deletemail.throws"> &title.throws; <para> <emphasis>throws</emphasis> no exceptions thrown </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.deletemail.note"> &title.note; ¬e.notstatic; </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-queue/mail-queue/get.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-queue/mail-queue/get.xml +++ peardoc/fr/package/mail/mail-queue/mail-queue/get.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.3 $ --> <!-- Translation comment : --> <refentry id="package.mail.mail-queue.mail-queue.get"> <refnamediv> <refname><function>Mail_Queue::get</function></refname> <refpurpose>Récupère le mail suivant dans la file.</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail/Queue.php'; </funcsynopsisinfo> <funcprototype> <funcdef>objet <function>Mail_Queue_Container::get</function></funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail-queue.mail-queue.get.desc"> &title.desc; <para> Récupère le mail suivant dans la file. Les emails sont préchargés dans un buffer en mémoire pour accélérer le prpcessus. Depuis <classname>Mail_Queue</classname> v.1.1, pour préserver la mémoire, la méthode <function>preload</function> ne précharge plus TOUS les mails mais une partie d'entre-eux. Le buffer s'auto-gère. Quand il est vide, il est automatiquement re-rempli. Vous pouvez fixer la taille du buffeur avec la méthode <function>setBufferSize</function>.</para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.get.returns"> &title.returns; <para> <emphasis>retourne</emphasis> un objet Mail_Queue_Body </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.get.throws"> &title.throws; <para> <emphasis>throws</emphasis> no exceptions thrown </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.get.note"> &title.note; ¬e.notstatic; </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-queue/mail-queue/put.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-queue/mail-queue/put.xml +++ peardoc/fr/package/mail/mail-queue/mail-queue/put.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.1 $ --> <!-- Translation comment : --> <refentry id="package.mail.mail-queue.mail-queue.put"> <refnamediv> <refname><function>Mail_Queue::put</function></refname> <refpurpose>Place un nouveau message dans la file.</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail/Queue.php'; </funcsynopsisinfo> <funcprototype> <funcdef>booléen <function>Mail_Queue::put</function></funcdef> <paramdef>chaîne <parameter>$expediteur</parameter></paramdef> <paramdef>chaîne <parameter>$destinataire</parameter></paramdef> <paramdef>tableau <parameter>$entete</parameter></paramdef> <paramdef>tableau <parameter>$corp</parameter></paramdef> <paramdef>entier <parameter> <optional>$sec_to_send = 0</optional></parameter></paramdef> <paramdef>booléen <parameter> <optional>$supprimer_apres_envoi = &true;</optional></parameter></paramdef> <paramdef>entier <parameter> <optional>$id_user = MAILQUEUE_SYSTEM</optional></parameter></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail-queue.mail-queue.put.desc"> &title.desc; <para> Ajoute un nouveau mail dans la file d'attente d'envoi. </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.put.param"> &title.param; <para> <variablelist> <varlistentry> <term> &type.string; <parameter>$expediteur</parameter> </term> <listitem> <para> Adresse e-mail de l'expéditeur. </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.string; <parameter>$destinataire</parameter> </term> <listitem> <para> Adresse e-mail du destinataire. </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.array; <parameter>$entetes</parameter> </term> <listitem> <para> Tableau des entêtes de l'email retourné par Mail_Mime::headers(). </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.array; <parameter>$corp</parameter> </term> <listitem> <para> Tableau de corps de l'email retourné par Mail_Mime::get(). </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.mixed; <parameter>$sec_to_send</parameter> </term> <listitem> <para> Optionnel - Delai en seconds avant tentative d'envoi. </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.mixed; <parameter>$supprimer_apres_envoi</parameter> </term> <listitem> <para> Optionnel - Si vrai, l'email est supprimé après envoi. </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.int; <parameter>$id_user</parameter> </term> <listitem> <para> Optionnel - ID user. Placé dans la file d'attente et lisible dans le corps du courrier avec getIdUser() par la suite. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.put.returns"> &title.returns; <para> <emphasis>retourne</emphasis> True en ca se réussite </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.put.throws"> &title.throws; <para> <emphasis>throws</emphasis> no exceptions thrown </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.put.note"> &title.note; ¬e.notstatic; </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-queue/mail-queue/sendmailbyid.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-queue/mail-queue/sendmailbyid.xml +++ peardoc/fr/package/mail/mail-queue/mail-queue/sendmailbyid.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.2 $ --> <refentry id="package.mail.mail-queue.mail-queue.sendmailbyid"> <refnamediv> <refname> <function>Mail_Queue::sendMailById</function> </refname> <refpurpose> Envoyer un mail bien précis de la file </refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail/Queue.php'; </funcsynopsisinfo> <funcprototype> <funcdef> booléen <function>Mail_Queue::sendMailById</function> </funcdef> <paramdef> entier <parameter>$id</parameter> </paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailbyid.desc"> &title.desc; <para> Envoie un courrier simple de la file d'attente identifié par $id. Note : Il ne sera pas supprimé automatiquement de la file d'attente après la livraison ! </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailbyid.param"> &title.param; <para> <variablelist> <varlistentry> <term> &type.int; <parameter>$id</parameter> </term> <listitem> <para> Identifieur du mail </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailbyid.returns"> &title.returns; <para> <emphasis>retourne</emphasis> Vrai en cas de succès. Faux en cas d'echec. </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailbyid.throws"> &title.throws; <para> <emphasis>throws</emphasis> no exceptions thrown </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailbyid.note"> &title.note; ¬e.notstatic; </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-queue/mail-queue/sendmailsinqueue.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-queue/mail-queue/sendmailsinqueue.xml +++ peardoc/fr/package/mail/mail-queue/mail-queue/sendmailsinqueue.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.1 $ --> <!-- Translation comment : --> <refentry id="package.mail.mail-queue.mail-queue.sendmailsinqueue"> <refnamediv> <refname> <function>Mail_Queue::sendMailsInQueue</function> </refname> <refpurpose>Envoie des email de la file d'attente.</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail/Queue.php'; </funcsynopsisinfo> <funcprototype> <funcdef>mixed <function>Mail_Queue::sendMailsInQueue</function></funcdef> <paramdef>integer <parameter> <optional>$limite = MAILQUEUE_ALL</optional></parameter></paramdef> <paramdef>integer <parameter> <optional>$decalage = MAILQUEUE_START</optional></parameter></paramdef> <paramdef>integer <parameter> <optional>$tentative = MAILQUEUE_TRY</optional></parameter></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailsinqueue.desc"> &title.desc; <para>Procède a l'envoi des courriers présents dans la file d'attente.</para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailsinqueue.param"> &title.param; <para> <variablelist> <varlistentry> <term> &type.int; <parameter>$limite</parameter> </term> <listitem> <para> Optionnel - Quantité maximum de mails à envoyer. </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.int; <parameter>$decalage</parameter> </term> <listitem> <para> Optionnel - ignore les $decalage premiers mails de la file d'attente. </para> </listitem> </varlistentry> </variablelist> <variablelist> <varlistentry> <term> &type.int; <parameter>$tentative</parameter> </term> <listitem> <para> Optionnel - nombre d'essais avant de remettre le mail dans la file pour une tentative ultérieure. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailsinqueue.returns"> &title.returns; <para> <emphasis>retourne</emphasis> Vrai en cas de réussite. Un objet Mail_Queue_Error en cas d'echec. </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailsinqueue.throws"> &title.throws; <para> <emphasis>throws</emphasis> no exceptions thrown </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmailsinqueue.note"> &title.note; ¬e.notstatic; </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-queue/mail-queue/sendmail.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-queue/mail-queue/sendmail.xml +++ peardoc/fr/package/mail/mail-queue/mail-queue/sendmail.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.3 $ --> <refentry id="package.mail.mail-queue.mail-queue.sendmail"> <refnamediv> <refname><function>Mail_Queue::sendMail</function></refname> <refpurpose>Procède à l'envoi des objets mails renvoyés par Mail_Queue::get()</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> require_once 'Mail/Queue.php'; </funcsynopsisinfo> <funcprototype> <funcdef>mixed <function>Mail_Queue::sendMail</function></funcdef> <paramdef>object MailBody <parameter>$mail</parameter></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="package.mail.mail-queue.mail-queue.sendmail.desc"> &title.desc; <para>Procède à l'envoi des objets mails renvoyés par Mail_Queue::get().</para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmail.param"> &title.param; <para> <variablelist> <varlistentry> <term> &type.object; MailBody <parameter>$mail</parameter> </term> <listitem> <para> Objet Mail. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmail.returns"> &title.returns; <para> <emphasis>retourne</emphasis> En cas de réussite, vrai. En cas d'echec une erreur de la classe pear. </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmail.throws"> &title.throws; <para> <emphasis>throws</emphasis> no exceptions thrown </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.sendmail.note"> &title.note; ¬e.notstatic; </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-queue/mail-queue/tutorial.xml?r=1.1&p=1 Index: peardoc/fr/package/mail/mail-queue/mail-queue/tutorial.xml +++ peardoc/fr/package/mail/mail-queue/mail-queue/tutorial.xml <!-- $Revision: 1.1 $ --> <!-- $EN-Revision: 1.3 $ --> <!-- translation comment: todo :ident, trans varnames of sample --> <refentry id="package.mail.mail-queue.mail-queue.tutorial"> <refnamediv> <refname>Tutorial</refname> <refpurpose>Un tutorial pour Mail_Queue</refpurpose> </refnamediv> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part1"> <title>Utilisation de Mail_Queue avec un exemple simple</title> <para> Nous utilisons pour cet exemple le db-container et une base de donnée mysql. Vous devez créer quelques tables dans cette base de donnée pour stocker les messages : </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part2"> <title /> <para> <example> <title>mysql.sql</title> <programlisting role="sql"> <![CDATA[ # # `mail_queue` # CREATE TABLE mail_queue ( id bigint(20) NOT NULL default '0', create_time datetime NOT NULL default '0000-00-00 00:00:00', time_to_send datetime NOT NULL default '0000-00-00 00:00:00', sent_time datetime default NULL, id_user bigint(20) NOT NULL default '0', ip varchar(20) NOT NULL default 'unknown', sender varchar(50) NOT NULL default '', recipient varchar(50) NOT NULL default '', headers text NOT NULL, body longtext NOT NULL, try_sent tinyint(4) NOT NULL default '0', delete_after_send tinyint(1) NOT NULL default '1', PRIMARY KEY (id), KEY id (id), KEY time_to_send (time_to_send), KEY id_user (id_user) ); # # `mail_queue_seq` # CREATE TABLE mail_queue_seq ( id int(10) unsigned NOT NULL auto_increment, PRIMARY KEY (id) ); # # Data for `mail_queue_seq` # INSERT INTO mail_queue_seq (id) VALUES (1); ]]> </programlisting> </example> </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part3"> <title /> <para> Premièrement, il faut définir certaines options. Comme vous avez besoin d'eux deux fois (une fois pour ajouter des messages, une fois pour envoyer les messages), il est toujours bon de les ajouter à un fichier de configuration. Nous l'appelerons config.php. </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part4"> <title /> <example> <title>config.php</title> <programlisting role="php"> <![CDATA[ <?php require_once "Mail/Queue.php"; // Options pour stocker les messages // type is the container used, currently there are db and mdb available $db_options['type'] = 'db'; // the others are the options for the used container // here are some for db $db_options['dsn'] = 'mysql://user:password@host/database'; $db_options['mail_table'] = 'mail_queue'; // Voici les options pour envoyer les messages eux-mêmes // ce sont les options requises pour la classe mail, // particulièrement utilisé pour Mail::factory() $mail_options['driver'] = 'smtp'; $mail_options['host'] = 'votre_serveur__smtp.tld'; $mail_options['port'] = 25; $mail_options['auth'] = false; $mail_options['username'] = ''; $mail_options['password'] = ''; ?> ]]> </programlisting> </example> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part5"> <title /> <para> Voilà la configuration faite, passons à l'utilisation. Premièrement il faudra construire un message et l'ajouter à la file: </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part6"> <title /> <example> <title>add_message.php</title> <programlisting role="php"> <![CDATA[ <?php include './config.php'; /* we use the db_options and mail_options here */ $mail_queue =& new Mail_Queue($db_options, $mail_options); $from = 'user@server.com'; $destinataire = "user2@server.com"; $message = 'Hi! This is test message!! :)'; $entetes = array( 'From' => $from, 'To' => $destinataire, 'Subject' => "Message de test" ); /* we use Mail_mime() to construct a valid mail */ $mime =& new Mail_mime(); $mime->setTXTBody($message); $corps = $mime->get(); $entetes = $mime->headers($entetes); /* Placer le message dans la file */ $mail_queue->put( $from, $destinataire, $entetes, $corps ); ?> ]]> </programlisting> </example> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part7"> <title /> <para> Ok, là nous avons utilisé la voie simple pour ajouter un message... Il y a des options plus avancées, consultez la documentation des fonctions d'ajout pour cela. Maintenant nous devons envoyer des messages. C'est la plupart du temp fait par un cron qui execute régulièrement un script pour envoyer les messages. Et maintenant ce petit script d'exemple : </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part8"> <title /> <example> <title>send_messages.php</title> <programlisting role="php"> <![CDATA[ <?php include './config.php'; /* Combien de courrier pourrons-nous envoyer chaque appel du script */ $max_amount_mails = 50; /* Nous utilisons à nouveau db_options et mail_options de la config */ $mail_queue =& new Mail_Queue($db_options, $mail_options); /* Envoi effectif des messages */ $mail_queue->sendMailsInQueue($max_amount_mails); ?> ]]> </programlisting> </example> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part9"> <title /> <para> Voilà c'est fait. Maintenant executez le script régulièrement et ajoutez vos mails à la file . </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part10"> <title /> <para> Depuis <classname>Mail_Queue</classname> v.1.1, la méthode <function>preload</function> peut ne plus précharger TOUS LES courriers dans la mémoire, mais juste quelques uns à la fois. Quand le buffer est vide, il est automatiquement re-rempli. Vous pouvez fixer la taille du buffer par l'intermédiaire de la nouvelle méthode <function>setBufferSize</function>. </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part11"> <title /> <para> Vous pouvez aussi voyer les emails stockés un par un. Voici un petit exemple pour illustrer cela : </para> </refsect1> <refsect1 id="package.mail.mail-queue.mail-queue.tutorial.part12"> <title /> <example> <title>send_messages_one_by_one.php</title> <programlisting role="php"> <![CDATA[ <?php // fixe la taille du tampon interne en fonction // des ressources mémoire disponible sur la machine // Le nombre indique la quantité maximum de mail qu'on // peut placer dans la file. $mail_queue->setBufferSize(20); //loop through the stored emails and send them // Boucler sur le lot de mail et les envoyer while ($mail = $mail_queue->get()) { $result = $mail_queue->sendMail($mail); } ?> ]]> </programlisting> </example> </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-executeMultiple-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 -->