documentation/manual/fr/module_specs/Zend_Mail-MultipleEmails.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 20819 -->
   3 <!-- Reviewed: no -->
   4 <sect1 id="zend.mail.multiple-emails">
   5     <title>Envoyer plusieurs émail par connexion SMTP</title>
   6
   7     <para>
   8         Par défaut un transport SMTP unique crée une connexion unique et la réutilise pour
   9         toute la durée de la vie du script. Vous pouvez envoyer plusieurs émail à travers cette
  10         connexion SMTP. Une commande RSET doit être envoyée avant chaque distribution pour garantir
  11         que le dialogue SMTP correct est respecté.
  12     </para>
  13
  14     <para>
  15         Optionally, you can also define a default From email address and name,
  16         as well as a default reply-to header. This can be done through the static
  17         methods <methodname>setDefaultFrom()</methodname> and
  18         <methodname>setDefaultReplyTo()</methodname>. These defaults will be used when you
  19         don't specify a From/Reply-to Address or -Name until the defaults are reset (cleared).
  20         Resetting the defaults can be done through the use of the
  21         <methodname>clearDefaultFrom()</methodname> and
  22         <methodname>clearDefaultReplyTo</methodname>.
  23     </para>
  24
  25     <example id="zend.mail.multiple-emails.example-1">
  26         <title>Envoyer plusieurs émail par connexion SMTP</title>
  27
  28         <programlisting language="php"><![CDATA[
  29 // Créer un transport
  30 $config = array('name' => 'sender.example.com');
  31 $transport = new Zend_Mail_Transport_Smtp('mail.example.com', $config);
  32
  33 // Ajouter les nom et adresses "From" & "Reply-To" pour tous les émails
  34 // à envoyer
  35 Zend_Mail::setDefaultFrom('sender@example.com', 'John Doe');
  36 Zend_Mail::setDefaultReplyTo('replyto@example.com','Jane Doe');
  37
  38 // Boucle à travers les messages
  39 for ($i = 0; $i < 5; $i++) {
  40     $mail = new Zend_Mail();
  41     $mail->addTo('studio@example.com', 'Test');
  42     $mail->setSubject(
  43         'Démonstration - Envoyer plusieurs emails par connexion SMTP'
  44     );
  45     $mail->setBodyText('...Votre message ici...');
  46     $mail->send($transport);
  47 }
  48
  49 // Effacer les valeurs par défaut
  50 Zend_Mail::clearDefaultFrom();
  51 Zend_Mail::clearDefaultReplyTo();
  52 ]]></programlisting>
  53     </example>
  54
  55     <para>
  56         Si vous voulez avoir une connexion SMTP séparée pour chaque distribution d'émail, vous
  57         devez créer et détruire votre transport avant et après chaque appel de la méthode
  58         <methodname>send()</methodname>. Ou sinon, vous pouvez manipuler la connexion entre chaque
  59         distribution en accédant à l'objet de protocole de transport.
  60     </para>
  61
  62     <example id="zend.mail.multiple-emails.example-2">
  63         <title>Contrôler manuellement la connexion de transport</title>
  64
  65         <programlisting language="php"><![CDATA[
  66 // Créer un transport
  67 $transport = new Zend_Mail_Transport_Smtp();
  68
  69 $protocol = new Zend_Mail_Protocol_Smtp('mail.example.com');
  70 $protocol->connect();
  71 $protocol->helo('sender.example.com');
  72
  73 $transport->setConnection($protocol);
  74
  75 // Boucle à travers les messages
  76 for ($i = 0; $i < 5; $i++) {
  77     $mail = new Zend_Mail();
  78     $mail->addTo('studio@example.com', 'Test');
  79     $mail->setFrom('studio@example.com', 'Test');
  80     $mail->setSubject(
  81         'Démonstration - Envoyer plusieurs emails par connexion SMTP'
  82     );
  83     $mail->setBodyText('...Votre message ici...');
  84
  85     // Contrôler manuellement la connexion
  86     $protocol->rset();
  87     $mail->send($transport);
  88 }
  89
  90 $protocol->quit();
  91 $protocol->disconnect();
  92 ]]></programlisting>
  93     </example>
  94 </sect1>