repo_zf1/documentation/manual/fr/module_specs/Zend_Mime_Message.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 20843 -->
<!-- Reviewed: no -->
<sect1 id="zend.mime.message">
    <title>Zend_Mime_Message</title>

    <sect2 id="zend.mime.message.introduction">
        <title>Introduction</title>

        <para>
            <classname>Zend_Mime_Message</classname> représente un message compatible <acronym>MIME</acronym> qui
            peut contenir une ou plusieurs parties séparées (représentées par des objets <link
            linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link>) Avec
            <classname>Zend_Mime_Message</classname>, les messages multiparts compatibles <acronym>MIME</acronym>
            peuvent être générés à partir de <classname>Zend_Mime_Part</classname>. L'encodage et la
            gestion des frontières sont gérées de manière transparente par la classe. Les objets
            <classname>Zend_Mime_Message</classname> peuvent aussi être reconstruits à partir de
            chaînes de caractères données (expérimental). Utilisés par <link
            linkend="zend.mail"><classname>Zend_Mail</classname></link>.
        </para>
    </sect2>

    <sect2 id="zend.mime.message.instantiation">
        <title>Instancier Zend_Mime_Message</title>

        <para>
            Il n'y a pas de constructeur explicite pour
            <classname>Zend_Mime_Message</classname>.
        </para>
    </sect2>

    <sect2 id="zend.mime.message.addparts">
        <title>Ajouter des parties MIME</title>

        <para>
            Les objets <link
            linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link> peuvent êtres
            ajoutés à un objet <classname>Zend_Mime_Message</classname> donné en appelant
            <code>-&gt;addPart($part)</code>.
        </para>

        <para>
            Un tableau avec toutes les objets <link
            linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link> du
            <classname>Zend_Mime_Message</classname> est retourné dans un tableau grâce à
            <code>-&gt;getParts()</code>. Les objets Zend_Mime_Part peuvent ainsi être changés car
            ils sont stockés dans le tableau comme références. Si des parties sont ajoutées au
            tableau, ou que la séquence est changée, le tableau à besoin d'être retourné à l'objet
            <link linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link> en appelant
            <code>-&gt;setParts($partsArray)</code>.
        </para>

        <para>
            La fonction <code>-&gt;isMultiPart()</code> retournera <constant>TRUE</constant> si plus
            d'une partie est enregistrée avec l'objet Zend_Mime_Message, l'objet pourra ainsi
            régénérer un objet Multipart-Mime-Message lors de la génération de la sortie.
        </para>
    </sect2>

    <sect2 id="zend.mime.message.bondary">
        <title>Gérer les frontières</title>

        <para>
            <classname>Zend_Mime_Message</classname> crée et utilise généralement son propre
            objet <classname>Zend_Mime</classname> pour générer une frontière. Si vous avez besoin
            de définir une frontière ou si vous voulez changer le comportement de l'objet
            <classname>Zend_Mime</classname> utilisé par <classname>Zend_Mime_Message</classname>,
            vous pouvez instancier l'objet <classname>Zend_Mime</classname> vous-même et
            l'enregistrer ensuite dans <classname>Zend_Mime_Message</classname>. Généralement, vous
            n'aurez pas besoin de faire cela. <code>-&gt;setMime(Zend_Mime $mime)</code> définit une
            instance spéciale de <classname>Zend_Mime</classname> pour qu'elle soit utilisée par ce
            Message.
        </para>

        <para>
            <code>-&gt;getMime()</code> retourne l'instance de
            <classname>Zend_Mime</classname> qui sera utilisée pour générer le message lorsque
            <methodname>generateMessage()</methodname> est appelée.
        </para>

        <para>
            <code>-&gt;generateMessage()</code> génère le contenu
            Z<classname>Zend_Mime_Message</classname> en une chaîne de caractères.
        </para>
    </sect2>

    <sect2 id="zend.mime.message.parse">
        <title>Parser une chaîne de caractère pour créer un objet Zend_Mime_Message
        (expérimental)</title>

        <para>
            Un message compatible <acronym>MIME</acronym> donné sous forme de chaîne de caractère peut être
            utilisé pour reconstruire un objet <classname>Zend_Mime_Message</classname>.
            <classname>Zend_Mime_Message</classname> a une méthode de fabrique statique pour parser
            cette chaîne et retourner un objet <classname>Zend_Mime_Message</classname>.
        </para>

        <para>
            <methodname>Zend_Mime_Message::createFromMessage($str, $boundary)</methodname>
            décode la chaîne de caractères donnée et retourne un objet
            <classname>Zend_Mime_Message</classname> qui peut ensuite être examiné en utilisant
            <code>-&gt;getParts()</code>.
        </para>
    </sect2>
</sect1>