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

<!-- EN-Revision: 13910 -->
<sect1 id="zend.mail.introduction">
    <title>Introduction</title>

    <sect2 id="zend.mail.introduction.getting-started">
        <title>Pour commencer</title>

        <para><classname>Zend_Mail</classname> fournit des fonctionnalités génériques pour écrire et envoyer des émail au format
        texte et MIME. Un émail peut-être envoyé avec <classname>Zend_Mail</classname> via le transporteur par défaut
        <classname>Zend_Mail_Transport_Sendmail</classname> ou via <classname>Zend_Mail_Transport_Smtp</classname>.</para>

        <example id="zend.mail.introduction.example-1">
            <title>Émail simple avec <classname>Zend_Mail</classname></title>

            <para>Un émail simple est composé d'un destinataire, d'un sujet, d'un message et d'un expéditeur. Pour
            envoyer ce genre de messages en utilisant <classname>Zend_Mail_Transport_Sendmail</classname>, vous pouvez faire comme
            ceci :</para>

            <programlisting role="php"><![CDATA[
$mail = new Zend_Mail();
$mail->setBodyText('Ceci est le texte du message.');
$mail->setFrom('somebody@example.com', 'un expéditeur');
$mail->addTo('somebody_else@example.com', 'un destinataire');
$mail->setSubject('Sujet de test');
$mail->send();
]]></programlisting>
        </example>

        <note>
            <title>Définitions minimales</title>

            <para>Pour envoyer un émail avec <classname>Zend_Mail</classname>, vous devez spécifier au moins un destinataire, un
            expéditeur (avec <code>setFrom()</code>), et un message (texte et/ou HTML).</para>
        </note>

        <para>Pour la plupart des attributs de l'émail, il y a des méthodes "get" pour lire les informations stockées
        dans l'objet mail. Pour plus de détails, merci de vous référer à la documentation de l'API. Une méthode spéciale
        est <code>getRecipients()</code>. Elle retourne un tableau avec toutes les adresses émail des destinataires qui
        ont été ajoutés avant l'appel de cette méthode.</para>

        <para>Pour des raisons de sécurité, <classname>Zend_Mail</classname> filtre tous les champs d'en-tête pour éviter tout
        problème d'injection d'en-têtes avec des caractères de nouvelles lignes (<code>\n</code>). Les guillemets
        doubles sont changés en guillemets simples et les crochets en parenthèses dans le nom des émetteurs et des
        destinataires. Si ces caractères sont dans l'adresse émail, ils sont enlevés.</para>

        <para>Vous pouvez aussi utiliser la plupart des méthodes de l'objet <classname>Zend_Mail</classname> via une interface
        fluide.</para>

        <programlisting role="php"><![CDATA[
$mail = new Zend_Mail();
$mail->setBodyText('Ceci est le texte du message.')
    ->setFrom('somebody@example.com', 'un expéditeur')
    ->addTo('somebody_else@example.com', 'un destinataire')
    ->setSubject('Sujet de test')
    ->send();
]]></programlisting>
    </sect2>

    <sect2 id="zend.mail.introduction.sendmail">
        <title>Configurer le transport sendmail par défaut</title>

        <para>Le transporteur par défaut pour une instance <classname>Zend_Mail</classname> est
        <classname>Zend_Mail_Transport_Sendmail</classname>. C'est essentiellement un paquet pour la fonction PHP <ulink
        url="http://php.net/mail"><code>mail()</code></ulink>. Si vous souhaitez fournir des paramètres additionnels à
        la fonction <ulink url="http://php.net/mail"><code>mail()</code></ulink>, créez simplement une nouvelle instance
        du transporteur et fournissez vos paramètres au constructeur. La nouvelle instance du transporteur peut ainsi
        devenir le transporteur par défaut <classname>Zend_Mail</classname>, ou il peut être fourni à la méthode
        <code>send()</code> de <classname>Zend_Mail</classname>.</para>

        <example id="zend.mail.introduction.sendmail.example-1">
            <title>Fournir des paramètres additionnels au transporteur
            <classname>Zend_Mail_Transport_Sendmail</classname></title>

            <para>Cet exemple montre comment changer le Return-Path de la fonction <ulink
            url="http://php.net/mail"><code>mail()</code></ulink>.</para>

            <programlisting role="php"><![CDATA[
$tr = new Zend_Mail_Transport_Sendmail('-freturn_to_me@example.com');
Zend_Mail::setDefaultTransport($tr);

$mail = new Zend_Mail();
$mail->setBodyText('Ceci est le texte du message.');
$mail->setFrom('somebody@example.com', 'un expéditeur');
$mail->addTo('somebody_else@example.com', 'un destinataire');
$mail->setSubject('TestSubject');
$mail->send();
]]></programlisting>
        </example>

        <note>
            <title>Restrictions en mode Safe</title>

            <para>Les paramètres additionnels optionnels peuvent entraînés un échec de la fonction <ulink
            url="http://php.net/mail"><code>mail()</code></ulink> si PHP fonctionne en mode safe.</para>
        </note>
    </sect2>
</sect1>