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

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.mail.attachments">
    <title>Fichiers joints</title>

    <para>
        Des fichiers peuvent-être attachés à un courriel en utilisant la méthode
        <methodname>createAttachment()</methodname>. 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 à <methodname>createAttachment()</methodname> :
    </para>

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

        <programlisting language="php"><![CDATA[
$mail = new Zend_Mail();
// construction du message
$mail->createAttachment($uneChaineBinaire);
$mail->createAttachment($monImage,
                        'image/gif',
                        Zend_Mime::DISPOSITION_INLINE,
                        Zend_Mime::ENCODING_BASE64);
]]></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 <methodname>createAttachment()</methodname> pour modifier ses attributs.
        La méthodes <methodname>createAttachment()</methodname> retourne un objet de type
        <classname>Zend_Mime_Part</classname> : <programlisting language="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_BASE64;
$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
        <methodname>addAttachment()</methodname> :
    </para>

    <programlisting language="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_BASE64;
$at->filename    = 'test.gif';

$mail->addAttachment($at);

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