<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<sect1 id="zend.mail.multiple-emails">
    <title>Sending Multiple Mails per SMTP Connection</title>

    <para>
        By default, a single SMTP transport creates a single connection and
        re-uses it for the lifetime of the script execution. You may send multiple
        e-mails through this SMTP connection. A RSET command is issued before each
        delivery to ensure the correct SMTP handshake is followed.
    </para>

    <para>
        Optionally, you can also define a default From email address and name,
        as well as a default reply-to header. This can be done through the static
        methods <methodname>setDefaultFrom()</methodname> and
        <methodname>setDefaultReplyTo()</methodname>. These defaults will be used when you
        don't specify a From/Reply-to Address or -Name until the defaults are reset (cleared).
        Resetting the defaults can be done through the use of the
        <methodname>clearDefaultFrom()</methodname> and
        <methodname>clearDefaultReplyTo</methodname>.
    </para>

    <example id="zend.mail.multiple-emails.example-1">
        <title>Sending Multiple Mails per SMTP Connection</title>

        <programlisting language="php"><![CDATA[
// Create transport
$config = array('name' => 'sender.example.com');
$transport = new Zend_Mail_Transport_Smtp('mail.example.com', $config);

// Set From & Reply-To address and name for all emails to send.
Zend_Mail::setDefaultFrom('sender@example.com', 'John Doe');
Zend_Mail::setDefaultReplyTo('replyto@example.com','Jane Doe');

// Loop through messages
for ($i = 0; $i < 5; $i++) {
    $mail = new Zend_Mail();
    $mail->addTo('studio@example.com', 'Test');

    $mail->setSubject(
        'Demonstration - Sending Multiple Mails per SMTP Connection'
    );
    $mail->setBodyText('...Your message here...');
    $mail->send($transport);
}

// Reset defaults
Zend_Mail::clearDefaultFrom();
Zend_Mail::clearDefaultReplyTo();
]]></programlisting>
    </example>

    <para>
        If you wish to have a separate connection for each mail
        delivery, you will need to create and destroy your transport before and
        after each <methodname>send()</methodname> method is called. Or alternatively,
        you can manipulate the connection between each delivery by accessing the
        transport's protocol object.
    </para>

    <example id="zend.mail.multiple-emails.example-2">
        <title>Manually controlling the transport connection</title>

        <programlisting language="php"><![CDATA[
// Create transport
$transport = new Zend_Mail_Transport_Smtp();

$protocol = new Zend_Mail_Protocol_Smtp('mail.example.com');
$protocol->connect();
$protocol->helo('sender.example.com');

$transport->setConnection($protocol);

// Loop through messages
for ($i = 0; $i < 5; $i++) {
    $mail = new Zend_Mail();
    $mail->addTo('studio@example.com', 'Test');
    $mail->setFrom('studio@example.com', 'Test');
    $mail->setSubject(
        'Demonstration - Sending Multiple Mails per SMTP Connection'
    );
    $mail->setBodyText('...Your message here...');

    // Manually control the connection
    $protocol->rset();
    $mail->send($transport);
}

$protocol->quit();
$protocol->disconnect();
]]></programlisting>
    </example>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->
