documentation/manual/fr/module_specs/Zend_Mime_Message.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 20843 -->
   3 <!-- Reviewed: no -->
   4 <sect1 id="zend.mime.message">
   5     <title>Zend_Mime_Message</title>
   6
   7     <sect2 id="zend.mime.message.introduction">
   8         <title>Introduction</title>
   9
  10         <para>
  11             <classname>Zend_Mime_Message</classname> représente un message compatible <acronym>MIME</acronym> qui
  12             peut contenir une ou plusieurs parties séparées (représentées par des objets <link
  13             linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link>) Avec
  14             <classname>Zend_Mime_Message</classname>, les messages multiparts compatibles <acronym>MIME</acronym>
  15             peuvent être générés à partir de <classname>Zend_Mime_Part</classname>. L'encodage et la
  16             gestion des frontières sont gérées de manière transparente par la classe. Les objets
  17             <classname>Zend_Mime_Message</classname> peuvent aussi être reconstruits à partir de
  18             chaînes de caractères données (expérimental). Utilisés par <link
  19             linkend="zend.mail"><classname>Zend_Mail</classname></link>.
  20         </para>
  21     </sect2>
  22
  23     <sect2 id="zend.mime.message.instantiation">
  24         <title>Instancier Zend_Mime_Message</title>
  25
  26         <para>
  27             Il n'y a pas de constructeur explicite pour
  28             <classname>Zend_Mime_Message</classname>.
  29         </para>
  30     </sect2>
  31
  32     <sect2 id="zend.mime.message.addparts">
  33         <title>Ajouter des parties MIME</title>
  34
  35         <para>
  36             Les objets <link
  37             linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link> peuvent êtres
  38             ajoutés à un objet <classname>Zend_Mime_Message</classname> donné en appelant
  39             <code>-&gt;addPart($part)</code>.
  40         </para>
  41
  42         <para>
  43             Un tableau avec toutes les objets <link
  44             linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link> du
  45             <classname>Zend_Mime_Message</classname> est retourné dans un tableau grâce à
  46             <code>-&gt;getParts()</code>. Les objets Zend_Mime_Part peuvent ainsi être changés car
  47             ils sont stockés dans le tableau comme références. Si des parties sont ajoutées au
  48             tableau, ou que la séquence est changée, le tableau à besoin d'être retourné à l'objet
  49             <link linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link> en appelant
  50             <code>-&gt;setParts($partsArray)</code>.
  51         </para>
  52
  53         <para>
  54             La fonction <code>-&gt;isMultiPart()</code> retournera <constant>TRUE</constant> si plus
  55             d'une partie est enregistrée avec l'objet Zend_Mime_Message, l'objet pourra ainsi
  56             régénérer un objet Multipart-Mime-Message lors de la génération de la sortie.
  57         </para>
  58     </sect2>
  59
  60     <sect2 id="zend.mime.message.bondary">
  61         <title>Gérer les frontières</title>
  62
  63         <para>
  64             <classname>Zend_Mime_Message</classname> crée et utilise généralement son propre
  65             objet <classname>Zend_Mime</classname> pour générer une frontière. Si vous avez besoin
  66             de définir une frontière ou si vous voulez changer le comportement de l'objet
  67             <classname>Zend_Mime</classname> utilisé par <classname>Zend_Mime_Message</classname>,
  68             vous pouvez instancier l'objet <classname>Zend_Mime</classname> vous-même et
  69             l'enregistrer ensuite dans <classname>Zend_Mime_Message</classname>. Généralement, vous
  70             n'aurez pas besoin de faire cela. <code>-&gt;setMime(Zend_Mime $mime)</code> définit une
  71             instance spéciale de <classname>Zend_Mime</classname> pour qu'elle soit utilisée par ce
  72             Message.
  73         </para>
  74
  75         <para>
  76             <code>-&gt;getMime()</code> retourne l'instance de
  77             <classname>Zend_Mime</classname> qui sera utilisée pour générer le message lorsque
  78             <methodname>generateMessage()</methodname> est appelée.
  79         </para>
  80
  81         <para>
  82             <code>-&gt;generateMessage()</code> génère le contenu
  83             Z<classname>Zend_Mime_Message</classname> en une chaîne de caractères.
  84         </para>
  85     </sect2>
  86
  87     <sect2 id="zend.mime.message.parse">
  88         <title>Parser une chaîne de caractère pour créer un objet Zend_Mime_Message
  89         (expérimental)</title>
  90
  91         <para>
  92             Un message compatible <acronym>MIME</acronym> donné sous forme de chaîne de caractère peut être
  93             utilisé pour reconstruire un objet <classname>Zend_Mime_Message</classname>.
  94             <classname>Zend_Mime_Message</classname> a une méthode de fabrique statique pour parser
  95             cette chaîne et retourner un objet <classname>Zend_Mime_Message</classname>.
  96         </para>
  97
  98         <para>
  99             <methodname>Zend_Mime_Message::createFromMessage($str, $boundary)</methodname>
 100             décode la chaîne de caractères donnée et retourne un objet
 101             <classname>Zend_Mime_Message</classname> qui peut ensuite être examiné en utilisant
 102             <code>-&gt;getParts()</code>.
 103         </para>
 104     </sect2>
 105 </sect1>