documentation/manual/fr/module_specs/Zend_Mime.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 20827 -->
   3 <!-- Reviewed: no -->
   4 <sect1 id="zend.mime.mime">
   5     <title>Zend_Mime</title>
   6
   7     <sect2 id="zend.mime.mime.introduction">
   8         <title>Introduction</title>
   9
  10         <para>
  11             <classname>Zend_Mime</classname> est une classe de support pour gérer les messages
  12             <acronym>MIME</acronym> en plusieurs parties. Elle est utilisé par <link
  13             linkend="zend.mail"><classname>Zend_Mail</classname></link> et <link
  14             linkend="zend.mime.message"><classname>Zend_Mime_Message</classname></link>, est
  15             peut-être utilisée dans l'application qui nécessite un support <acronym>MIME</acronym>.
  16         </para>
  17     </sect2>
  18
  19     <sect2 id="zend.mime.mime.static">
  20         <title>Méthodes statiques et constantes</title>
  21
  22         <para>
  23             <classname>Zend_Mime</classname> fournit un jeu simple de méthodes statiques pour
  24             fonctionner avec <acronym>MIME</acronym> : <itemizedlist>
  25                     <listitem>
  26                     <para>
  27                         <methodname>Zend_Mime::isPrintable()</methodname>: retourne
  28                         <constant>TRUE</constant> si la chaine données contient des caractères non
  29                         imprimables. <constant>FALSE</constant> dans les autres cas.
  30                     </para>
  31                 </listitem>
  32
  33                 <listitem>
  34                      <para>
  35                         <methodname>Zend_Mime::encode()</methodname>: encode
  36                         une chaîne en utilisant l'encodage spécifié.
  37                     </para>
  38                 </listitem>
  39
  40                 <listitem>
  41                     <para>
  42                         <methodname>Zend_Mime::encodeBase64()encodeBase64()</methodname>: encode
  43                         une chaîne en utilisant base64.
  44                     </para>
  45                 </listitem>
  46
  47                 <listitem>
  48                     <para>
  49                         <methodname>Zend_Mime::encodeQuotedPrintable()</methodname>: encode une
  50                         chaîne avec le mécanisme quoted-printable.
  51                     </para>
  52                 </listitem>
  53
  54                 <listitem>
  55                     <para>
  56                         <methodname>Zend_Mime::encodeBase64Header()</methodname>: encode
  57                         une chaîne en utilisant base64 pour les entêtes émail.
  58                     </para>
  59                 </listitem>
  60
  61                 <listitem>
  62                     <para>
  63                         <methodname>Zend_Mime::encodeQuotedPrintableHeader()</methodname>: ncode une
  64                         chaîne avec le mécanisme quoted-printable pour les entêtes émail.
  65                     </para>
  66                 </listitem>
  67             </itemizedlist>
  68             </para>
  69
  70         <para>
  71             <classname>Zend_Mime</classname> définit un jeu de constantes communément utilisé
  72             avec des messages <acronym>MIME</acronym> : <itemizedlist>
  73                     <listitem>
  74                     <para>
  75                         <classname>Zend_Mime::TYPE_OCTETSTREAM</classname>:
  76                         "application/octet-stream"
  77                     </para>
  78                 </listitem>
  79
  80                 <listitem>
  81                     <para><classname>Zend_Mime::TYPE_TEXT</classname>: "text/plain"</para>
  82                 </listitem>
  83
  84                 <listitem>
  85                     <para><classname>Zend_Mime::TYPE_HTML</classname>: "text/html"</para>
  86                 </listitem>
  87
  88                 <listitem>
  89                     <para><classname>Zend_Mime::ENCODING_7BIT</classname>: "7bit"</para>
  90                 </listitem>
  91
  92                 <listitem>
  93                     <para><classname>Zend_Mime::ENCODING_8BIT</classname>: "8bit"</para>
  94                 </listitem>
  95
  96                 <listitem>
  97                     <para>
  98                         <classname>Zend_Mime::ENCODING_QUOTEDPRINTABLE</classname>:
  99                         "quoted-printable"
 100                     </para>
 101                 </listitem>
 102
 103                 <listitem>
 104                     <para><classname>Zend_Mime::ENCODING_BASE64</classname>: "base64"</para>
 105                 </listitem>
 106
 107                 <listitem>
 108                     <para>
 109                         <classname>Zend_Mime::DISPOSITION_ATTACHMENT</classname>:
 110                         "attachment"
 111                     </para>
 112                 </listitem>
 113
 114                 <listitem>
 115                     <para><classname>Zend_Mime::DISPOSITION_INLINE</classname>: "inline"</para>
 116                 </listitem>
 117
 118                 <listitem>
 119                     <para>
 120                         <constant>Zend_Mime::MULTIPART_ALTERNATIVE</constant>:
 121                         'multipart/alternative'
 122                     </para>
 123                 </listitem>
 124
 125                 <listitem>
 126                     <para>
 127                         <constant>Zend_Mime::MULTIPART_MIXED</constant>: 'multipart/mixed'
 128                     </para>
 129                 </listitem>
 130
 131                 <listitem>
 132                     <para>
 133                         <constant>Zend_Mime::MULTIPART_RELATED</constant>: 'multipart/related'
 134                     </para>
 135                 </listitem>
 136             </itemizedlist>
 137             </para>
 138     </sect2>
 139
 140     <sect2 id="zend.mime.mime.instatiation">
 141         <title>Instancier Zend_Mime</title>
 142
 143         <para>
 144             Lors de l'instanciation d'un objet <classname>Zend_Mime</classname>, une frontière
 145             <acronym>MIME</acronym> est stockée pour qu'elle soit utilisée pour tous les appels aux méthodes statiques
 146             suivant, sur cet objet. Si le constructeur est appelé avec une chaîne en paramètre,
 147             cette valeur sera utilisée comme frontière <acronym>MIME</acronym>. Sinon, une frontière <acronym>MIME</acronym> aléatoire
 148             sera générée lors de la construction.
 149         </para>
 150
 151         <para>
 152             Un objet <classname>Zend_Mime</classname> contient les méthodes suivantes :
 153             <itemizedlist>
 154                     <listitem>
 155                         <para><methodname>boundary()</methodname>: retourne la frontière <acronym>MIME</acronym>.</para>
 156                     </listitem>
 157
 158                     <listitem>
 159                     <para>
 160                         <methodname>boundaryLine()</methodname>: retourne la ligne complète de la
 161                         frontière <acronym>MIME</acronym>.
 162                     </para>
 163                 </listitem>
 164
 165                 <listitem>
 166                     <para>
 167                         <methodname>mimeEnd()</methodname>: retourne la fin de la frontière <acronym>MIME</acronym>
 168                         complète.
 169                     </para>
 170                 </listitem>
 171                 </itemizedlist>
 172             </para>
 173     </sect2>
 174 </sect1>