documentation/manual/zh/module_specs/Zend_Mime_Part.xml

   1 <sect1 id="zend.mime.part">
   2     <title>Zend_Mime_Part</title>
   3
   4     <sect2 id="zend.mime.part.introduction">
   5       <title> 简介 </title>
   6       <para>
   7           <code>Zend_Mime_Part</code>表示 MIME 消息的一个段。它包含了MIME消息段的实际内容以及编码、内容类型和原始的文件名等一些附加信息。它也提供了一个方法，用来从存储的数据产生字符串。<code>Zend_Mime_Part</code>对象可以被添加到<link linkend="zend.mime.message"><code>Zend_Mime_Message</code></link>中去，来聚合产生一个完整的多段的MIME消息。
   8       </para>
   9     </sect2>
  10
  11   <sect2 id="zend.mime.part.instantiation">
  12     <title> 实例化 </title>
  13
  14     <para>
  15       <code>Zend_Mime_Part</code>通过表示段的内容的字符串来实例化。缺省的内容类型为OCTET-STREAM，编码为8Bit。在<code>Zend_Mime_Part</code>实例化之后, 可以直接访问它的属性来设置元信息：
  16     </para>
  17
  18     <programlisting role="php"><![CDATA[<?php
  19 public $type = ZMime::TYPE_OCTETSTREAM;
  20 public $encoding = ZMime::ENCODING_8BIT;
  21 public $id;
  22 public $disposition;
  23 public $filename;
  24 public $description;
  25 public $charset;]]>
  26     </programlisting>
  27     </sect2>
  28
  29   <sect2 id="zend.mime.part.methods">
  30     <title> 解析（rendering）消息段为字符串的方法 </title>
  31
  32     <para>
  33         <code>getContent()</code>方法，返回经过编码的消息段字符串，编码方式由属性$encoding指定。有效的编码方式为Zend_Mime::ENCODING_*。字符集的转换还未实现。
  34    </para>
  35
  36     <para>
  37         <code>getHeaders()</code>方法，返回产自对象公有属性的MIME消息段的消息头。在该方法调用之前，对象的这些共有属性必须被正确的设置。
  38         <itemizedlist>
  39             <listitem>
  40                 <para>
  41                     <code>$charset</code>
  42                     如果内容为Text类型(纯文本或HTML)，该属性被设置为实际的字符集。
  43                 </para>
  44             </listitem>
  45             <listitem>
  46                 <para>
  47                     <code>$id</code>
  48                     可能被设置，用来标识HTML邮件中内嵌图片的content-id。
  49                 </para>
  50             </listitem>
  51             <listitem>
  52                 <para>
  53                     <code>$filename</code>
  54                        给出了当文件被下载时的文件名。
  55                 </para>
  56             </listitem>
  57             <listitem>
  58                 <para>
  59                     <code>$disposition</code>
  60                        指定了文件是当作附件，还是当作邮件的内嵌资源。
  61                 </para>
  62             </listitem>
  63             <listitem>
  64                 <para>
  65                     <code>$description</code>
  66                        只用在提供信息上。
  67                 </para>
  68             </listitem>
  69         </itemizedlist>
  70     </para>
  71   </sect2>
  72 </sect1>
  73 <!--
  74 vim:se ts=4 sw=4 et:
  75 -->