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

<!-- EN-Revision: 11495 -->
<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 MIME 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 MIME 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 <code>true</code> 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 <code>generateMessage()</code> 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 MIME 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><classname>Zend_Mime_Message::createFromMessage($str, $boundary)</classname> 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>