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

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

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

        <para>
            <classname>Zend_Mime</classname> est une classe de support pour gérer les messages
            <acronym>MIME</acronym> en plusieurs parties. Elle est utilisé par <link
            linkend="zend.mail"><classname>Zend_Mail</classname></link> et <link
            linkend="zend.mime.message"><classname>Zend_Mime_Message</classname></link>, est
            peut-être utilisée dans l'application qui nécessite un support <acronym>MIME</acronym>.
        </para>
    </sect2>

    <sect2 id="zend.mime.mime.static">
        <title>Méthodes statiques et constantes</title>

        <para>
            <classname>Zend_Mime</classname> fournit un jeu simple de méthodes statiques pour
            fonctionner avec <acronym>MIME</acronym> : <itemizedlist>
                    <listitem>
                    <para>
                        <methodname>Zend_Mime::isPrintable()</methodname>: retourne
                        <constant>TRUE</constant> si la chaine données contient des caractères non
                        imprimables. <constant>FALSE</constant> dans les autres cas.
                    </para>
                </listitem>

                <listitem>
                     <para>
                        <methodname>Zend_Mime::encode()</methodname>: encode
                        une chaîne en utilisant l'encodage spécifié.
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <methodname>Zend_Mime::encodeBase64()encodeBase64()</methodname>: encode
                        une chaîne en utilisant base64.
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <methodname>Zend_Mime::encodeQuotedPrintable()</methodname>: encode une
                        chaîne avec le mécanisme quoted-printable.
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <methodname>Zend_Mime::encodeBase64Header()</methodname>: encode
                        une chaîne en utilisant base64 pour les en-têtes du courriel.
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <methodname>Zend_Mime::encodeQuotedPrintableHeader()</methodname>: encode une
                        chaîne avec le mécanisme quoted-printable pour les en-têtes du courriel.
                    </para>
                </listitem>
            </itemizedlist>
            </para>

        <para>
            <classname>Zend_Mime</classname> définit un jeu de constantes communément utilisé
            avec des messages <acronym>MIME</acronym> : <itemizedlist>
                    <listitem>
                    <para>
                        <classname>Zend_Mime::TYPE_OCTETSTREAM</classname>:
                        "application/octet-stream"
                    </para>
                </listitem>

                <listitem>
                    <para><classname>Zend_Mime::TYPE_TEXT</classname>: "text/plain"</para>
                </listitem>

                <listitem>
                    <para><classname>Zend_Mime::TYPE_HTML</classname>: "text/html"</para>
                </listitem>

                <listitem>
                    <para><classname>Zend_Mime::ENCODING_7BIT</classname>: "7bit"</para>
                </listitem>

                <listitem>
                    <para><classname>Zend_Mime::ENCODING_8BIT</classname>: "8bit"</para>
                </listitem>

                <listitem>
                    <para>
                        <classname>Zend_Mime::ENCODING_QUOTEDPRINTABLE</classname>:
                        "quoted-printable"
                    </para>
                </listitem>

                <listitem>
                    <para><classname>Zend_Mime::ENCODING_BASE64</classname>: "base64"</para>
                </listitem>

                <listitem>
                    <para>
                        <classname>Zend_Mime::DISPOSITION_ATTACHMENT</classname>:
                        "attachment"
                    </para>
                </listitem>

                <listitem>
                    <para><classname>Zend_Mime::DISPOSITION_INLINE</classname>: "inline"</para>
                </listitem>

                <listitem>
                    <para>
                        <constant>Zend_Mime::MULTIPART_ALTERNATIVE</constant>:
                        'multipart/alternative'
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <constant>Zend_Mime::MULTIPART_MIXED</constant>: 'multipart/mixed'
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <constant>Zend_Mime::MULTIPART_RELATED</constant>: 'multipart/related'
                    </para>
                </listitem>
            </itemizedlist>
            </para>
    </sect2>

    <sect2 id="zend.mime.mime.instatiation">
        <title>Instancier Zend_Mime</title>

        <para>
            Lors de l'instanciation d'un objet <classname>Zend_Mime</classname>, une frontière
            <acronym>MIME</acronym> est stockée pour qu'elle soit utilisée pour tous les appels aux méthodes statiques
            suivant, sur cet objet. Si le constructeur est appelé avec une chaîne en paramètre,
            cette valeur sera utilisée comme frontière <acronym>MIME</acronym>. Sinon, une frontière <acronym>MIME</acronym> aléatoire
            sera générée lors de la construction.
        </para>

        <para>
            Un objet <classname>Zend_Mime</classname> contient les méthodes suivantes :
            <itemizedlist>
                    <listitem>
                        <para><methodname>boundary()</methodname>: retourne la frontière <acronym>MIME</acronym>.</para>
                    </listitem>

                    <listitem>
                    <para>
                        <methodname>boundaryLine()</methodname>: retourne la ligne complète de la
                        frontière <acronym>MIME</acronym>.
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <methodname>mimeEnd()</methodname>: retourne la fin de la frontière <acronym>MIME</acronym>
                        complète.
                    </para>
                </listitem>
                </itemizedlist>
            </para>
    </sect2>
</sect1>