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

<!-- EN-Revision: 12754 -->
<sect1 id="zend.mail.attachments">
    <title>Fichiers joints</title>

    <para>Des fichiers peuvent-être attachés à un émail en utilisant la méthode <code>createAttachment()</code>. Le
    comportement par défaut de <classname>Zend_Mail</classname> est de définir que le fichier joint est un objet binaire
    (application/octet-stream), qui devra être transféré avec un encodage de type base64, et est définit comme une pièce
    jointe. Ce comportement peut être redéfinit en passant plus de paramètres à <code>createAttachment()</code> :</para>

    <example id="zend.mail.attachments.example-1">
        <title>Émail avec fichiers joints</title>

        <programlisting role="php"><![CDATA[
$mail = new Zend_Mail();
// construction du message
$mail->createAttachment($uneChaineBinaire);
$mail->createAttachment($monImage,
                        'image/gif',
                        Zend_Mime::DISPOSITION_INLINE,
                        Zend_Mime::ENCODING_8BIT);
]]></programlisting>
    </example>

    <para>Si vous voulez contrôler la partie MIME générée pour un fichier joint, vous pouvez utiliser la valeur
    retournée de <code>createAttachment()</code> pour modifier ses attributs. La méthodes
    <code>createAttachment()</code> retourne un objet de type <classname>Zend_Mime_Part</classname> : <programlisting
    role="php"><![CDATA[
$mail = new Zend_Mail();

$at = $mail->createAttachment($monImage);
$at->type        = 'image/gif';
$at->disposition = Zend_Mime::DISPOSITION_INLINE;
$at->encoding    = Zend_Mime::ENCODING_8BIT;
$at->filename    = 'test.gif';

$mail->send();
]]></programlisting></para>

    <para>Une façon alternative est de créer une instance de <classname>Zend_Mime_Part</classname> et de l'ajouter avec la méthode
    <code>addAttachment()</code> :</para>

    <programlisting role="php"><![CDATA[
$mail = new Zend_Mail();

$at = new Zend_Mime_Part($monImage);
$at->type        = 'image/gif';
$at->disposition = Zend_Mime::DISPOSITION_INLINE;
$at->encoding    = Zend_Mime::ENCODING_8BIT;
$at->filename    = 'test.gif';

$mail->addAttachment($at);

$mail->send();
]]></programlisting>
</sect1>