repo_zf1/documentation/manual/zh/module_specs/Zend_Mime_Part.xml

<sect1 id="zend.mime.part">
    <title>Zend_Mime_Part</title>

    <sect2 id="zend.mime.part.introduction">
      <title> 简介 </title>
      <para>
          <code>Zend_Mime_Part</code>表示 MIME 消息的一个段。它包含了MIME消息段的实际内容以及编码、内容类型和原始的文件名等一些附加信息。它也提供了一个方法，用来从存储的数据产生字符串。<code>Zend_Mime_Part</code>对象可以被添加到<link linkend="zend.mime.message"><code>Zend_Mime_Message</code></link>中去，来聚合产生一个完整的多段的MIME消息。
      </para>
    </sect2>

  <sect2 id="zend.mime.part.instantiation">
    <title> 实例化 </title>

    <para>
      <code>Zend_Mime_Part</code>通过表示段的内容的字符串来实例化。缺省的内容类型为OCTET-STREAM，编码为8Bit。在<code>Zend_Mime_Part</code>实例化之后, 可以直接访问它的属性来设置元信息：
    </para>

    <programlisting role="php"><![CDATA[<?php
public $type = ZMime::TYPE_OCTETSTREAM;
public $encoding = ZMime::ENCODING_8BIT;
public $id;
public $disposition;
public $filename;
public $description;
public $charset;]]>
    </programlisting>
    </sect2>

  <sect2 id="zend.mime.part.methods">
    <title> 解析（rendering）消息段为字符串的方法 </title>

    <para>
        <code>getContent()</code>方法，返回经过编码的消息段字符串，编码方式由属性$encoding指定。有效的编码方式为Zend_Mime::ENCODING_*。字符集的转换还未实现。
   </para>

    <para>
        <code>getHeaders()</code>方法，返回产自对象公有属性的MIME消息段的消息头。在该方法调用之前，对象的这些共有属性必须被正确的设置。
        <itemizedlist>
            <listitem>
                <para>
                    <code>$charset</code>
                    如果内容为Text类型(纯文本或HTML)，该属性被设置为实际的字符集。
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>$id</code>
                    可能被设置，用来标识HTML邮件中内嵌图片的content-id。
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>$filename</code>
                       给出了当文件被下载时的文件名。
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>$disposition</code>
                       指定了文件是当作附件，还是当作邮件的内嵌资源。
                </para>
            </listitem>
            <listitem>
                <para>
                    <code>$description</code>
                       只用在提供信息上。
                </para>
            </listitem>
        </itemizedlist>
    </para>
  </sect2>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->