repo_zf1/documentation/manual/ru/module_specs/Zend_Mail-Introduction.xml

<sect1 id="zend.mail.introduction">
    <title>Введение</title>
    <para>
        <code>Zend_Mail</code> предоставляет обобщенный функционал для формирования
        и отправки как текстовых, так и MIME-сообщений электронной почты.
        Сообщения могут отправляться <code>Zend_Mail</code> посредством
        встроенной функции PHP <ulink url="http://php.net/mail"><code>mail()</code></ulink>
        или прямого соединения SMTP.
<!--
        <code>Zend_Mail</code> provides generalized functionality to compose and send both text and MIME-compliant
        multipart e-mail messages. Mail can be sent with <code>Zend_Mail</code> via the php built-in
        <ulink url="http://php.net/mail"><code>mail()</code></ulink> function or via direct SMTP connection.
-->
    </para>
    <example>
        <title>
            Простое сообщение электронной почты
<!--
            Simple E-Mail with Zend_Mail
-->
        </title>
        <para>
            Простое сообщение электронной почты содержит несколько получателей,
            заголовок сообщения, тело сообщения и отправителя.
            Чтобы отправить такое электронное сообщение, используя функцию PHP
            <ulink url="http://php.net/mail"><code>mail()</code></ulink>,
            сделайте следующее:
<!--
            A simple e-mail consists of some recipients, a subject, a body and a sender. To send such a mail using
            the PHP <ulink url="http://php.net/mail"><code>mail()</code></ulink> function, do the following:
-->
        </para>
        <programlisting language="php"><![CDATA[<?php
require_once 'Zend/Mail.php';
$mail = new Zend_Mail();
$mail->setBodyText('This is the text of the mail.');
$mail->setFrom('somebody@example.com', 'Some Sender');
$mail->addTo('somebody_else@example.com', 'Some Recipient');
$mail->setSubject('TestSubject');
$mail->send();
?>]]>   </programlisting>
    </example>
    <note>
        <title>Минимально необходимые определения<!--Minimum definitions--></title>
        <para>
            Чтобы отправить сообщение с помощью <code>Zend_Mail</code>, вы должны
            указать как минимум одного получателя, отправителя (например, с помощью
            <code>setFrom()</code>), и текст сообщения (текстовое и/или в формате HTML).
<!--
            In order to send an e-mail with <code>Zend_Mail</code> you have to specify at least one recipient, a
            sender (e.g., with <code>setFrom()</code>), and a message body (text and/or HTML).
-->
        </para>
    </note>
    <para>
        Для большинства атрибутов сообщений электронной почты есть методы
        "get" для чтения информации, сохраненной в объекте сообщения.
        За более подробной информацией, пожалуйста, обратитесь к документации
        по API. Особым является метод <code>getRecipients()</code>.
        Он возвращает массив с адресами электронной почты получателей,
        в порядке их добавления.
<!--
        For most mail attributes there are "get" methods to read the information stored in the mail object. For
        further details, please refer to the API documentation. A special one is <code>getRecipients()</code>.
        It returns an array with all recipient e-mail addresses that were added prior to the method call.
-->
    </para>
    <para>
        В целях безопасности <code>Zend_Mail</code> фильтрует все содержимое заголовков
        для предотвращения инъекций в заголовки с использованием символов новой
        строки (<code>\n</code>).
<!--
        For security reasons, <code>Zend_Mail</code> filters all header fields to prevent header injection with
        newline (<code>\n</code>) characters.
-->
    </para>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->