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

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <!-- EN-Revision: 20819 -->
   4 <sect1 id="zend.mail.multiple-emails">
   5     <title>SMTP 接続による複数のメールの送信</title>
   6
   7     <para>
   8         デフォルトでは、ひとつの SMTP トランスポートが
   9         ひとつの接続を作成し、スクリプトの実行中はそれを使いまわします。
  10         この SMTP 接続で、複数のメールを送信できます。
  11         SMTP のハンドシェイクを正しく行うには、
  12         メッセージの配送の前に RSET コマンドを発行します。
  13     </para>
  14
  15     <para>
  16         任意で、既定の reply-to ヘッダだけではなく、既定の email アドレスと名前も
  17         定義できます。これは静的メソッド <methodname>setDefaultFrom()</methodname>
  18         及び <methodname>setDefaultReplyTo()</methodname> を介して行なわれます。
  19         これらの既定値は、既定値がリセット（消去）されるまで、 From/Reply-to のアドレスや
  20         名前を指定しない場合に使われます。
  21         既定値は <methodname>clearDefaultFrom()</methodname> 及び
  22         <methodname>clearDefaultReplyTo</methodname> を使って消去されます。
  23     </para>
  24
  25     <example id="zend.mail.multiple-emails.example-1">
  26
  27         <title>SMTP 接続による複数のメールの送信</title>
  28
  29         <programlisting language="php"><![CDATA[
  30 // トランスポートを作成します
  31 $config = array('name' => 'sender.example.com');
  32 $transport = new Zend_Mail_Transport_Smtp('mail.example.com', $config);
  33
  34 // 送信するメール全てで使う From 及び Reply-To のアドレス及び名前を設定します
  35 Zend_Mail::setDefaultFrom('sender@example.com', 'John Doe');
  36 Zend_Mail::setDefaultReplyTo('replyto@example.com','Jane Doe');
  37
  38 // メッセージをループ処理します
  39 for ($i = 0; $i < 5; $i++) {
  40     $mail = new Zend_Mail();
  41     $mail->addTo('studio@example.com', 'Test');
  42     $mail->setSubject(
  43         'Demonstration - Sending Multiple Mails per SMTP Connection'
  44     );
  45     $mail->setBodyText('...Your message here...');
  46     $mail->send($transport);
  47 }
  48
  49 // 既定値をリセットします
  50 Zend_Mail::clearDefaultFrom();
  51 Zend_Mail::clearDefaultReplyTo();
  52 ]]></programlisting>
  53
  54     </example>
  55
  56     <para>
  57         各配送ごとに別々の接続を使用したい場合は、
  58         <methodname>send()</methodname> メソッドのコールの前後に
  59         トランスポートの作成と廃棄をする必要があります。
  60         あるいは、トランスポートのプロトコルオブジェクトを用いて
  61         各配送の接続を操作することもできます。
  62     </para>
  63
  64     <example id="zend.mail.multiple-emails.example-2">
  65
  66         <title>トランスポートの接続の手動制御</title>
  67
  68         <programlisting language="php"><![CDATA[
  69 // トランスポートを作成します
  70 $transport = new Zend_Mail_Transport_Smtp();
  71
  72 $protocol = new Zend_Mail_Protocol_Smtp('mail.example.com');
  73 $protocol->connect();
  74 $protocol->helo('sender.example.com');
  75
  76 $transport->setConnection($protocol);
  77
  78 // メッセージをループ処理します
  79 for ($i = 0; $i < 5; $i++) {
  80     $mail = new Zend_Mail();
  81     $mail->addTo('studio@example.com', 'Test');
  82     $mail->setFrom('studio@example.com', 'Test');
  83     $mail->setSubject(
  84         'Demonstration - Sending Multiple Mails per SMTP Connection'
  85     );
  86     $mail->setBodyText('...Your message here...');
  87
  88     // 手動で接続を制御します
  89     $protocol->rset();
  90     $mail->send($transport);
  91 }
  92
  93 $protocol->quit();
  94 $protocol->disconnect();
  95 ]]></programlisting>
  96
  97     </example>
  98
  99 </sect1>
 100 <!--
 101 vim:se ts=4 sw=4 et:
 102 -->