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

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

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

        <para>
            <classname>Zend_Mime</classname> は、マルチパート <acronym>MIME</acronym>
            メッセージを処理するためのサポートクラスです。
            <link linkend="zend.mail"><classname>Zend_Mail</classname></link> や
            <link linkend="zend.mime.message"><classname>Zend_Mime_Message</classname></link>、
            そして <acronym>MIME</acronym> サポートを必要とするその他のアプリケーションから使用されます。
        </para>
    </sect2>

    <sect2 id="zend.mime.mime.static">
        <title>静的メソッドおよび定数</title>

        <para>
            <classname>Zend_Mime</classname> は、<acronym>MIME</acronym> を処理するための以下のような静的ヘルパーメソッドを提供しています。

            <itemizedlist>
                <listitem>
                    <para>
                        <methodname>Zend_Mime::isPrintable()</methodname>:
                        指定した文字列の中に表示できない文字がなければ <constant>TRUE</constant> 、
                        それ以外の場合に <constant>FALSE</constant> を返します。
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <methodname>Zend_Mime::encode()</methodname>: 指定されたエンコードで文字列を エンコードします。
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <methodname>Zend_Mime::encodeBase64()</methodname>: 文字列を base64 でエンコードします。
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <methodname>Zend_Mime::encodeQuotedPrintable()</methodname>:
                        文字列を quoted-printable でエンコードします。
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <methodname>Zend_Mime::encodeBase64Header()</methodname>:
                        メールヘッダ用に文字列を base64 でエンコードします。
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <methodname>Zend_Mime::encodeQuotedPrintableHeader()</methodname>:
                        メールヘッダ用に文字列を quoted-printable でエンコードします。
                    </para>
                </listitem>
            </itemizedlist>
        </para>

        <para>
            <classname>Zend_Mime</classname> では、<acronym>MIME</acronym> メッセージでよく使われる定数を定義しています。

            <itemizedlist>
                <listitem>
                    <para>
                        <constant>Zend_Mime::TYPE_OCTETSTREAM</constant>: 'application/octet-stream'
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <constant>Zend_Mime::TYPE_TEXT</constant>: 'text/plain'
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <constant>Zend_Mime::TYPE_HTML</constant>: 'text/html'
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <constant>Zend_Mime::ENCODING_7BIT</constant>: '7bit'
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <constant>Zend_Mime::ENCODING_8BIT</constant>: '8bit'
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <constant>Zend_Mime::ENCODING_QUOTEDPRINTABLE</constant>: 'quoted-printable'
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <constant>Zend_Mime::ENCODING_BASE64</constant>: 'base64'
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <constant>Zend_Mime::DISPOSITION_ATTACHMENT</constant>: 'attachment'
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <constant>Zend_Mime::DISPOSITION_INLINE</constant>: '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>Zend_Mime インスタンスの作成</title>

        <para>
            <classname>Zend_Mime</classname> オブジェクトのインスタンスを作成する際に、
            <acronym>MIME</acronym> バウンダリが作成されます。それ以降にこのオブジェクトの
            (静的でない) メソッドがコールされるときには、このバウンダリが使用されます。
            文字列パラメータを指定してコンストラクタがコールされた場合は、
            その値が <acronym>MIME</acronym> バウンダリとして使用されます。指定されなかった場合は、
            ランダムな <acronym>MIME</acronym> バウンダリがコンストラクタのコール時に生成されます。
        </para>

        <para>
            <classname>Zend_Mime</classname> オブジェクトには次のメソッドがあります。

            <itemizedlist>
                <listitem>
                    <para>
                        <methodname>boundary()</methodname>: <acronym>MIME</acronym> バウンダリ文字列を返します。
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <methodname>boundaryLine()</methodname>: 完全な <acronym>MIME</acronym> バウンダリ行を返します。
                    </para>
                </listitem>

                <listitem>
                    <para>
                        <methodname>mimeEnd()</methodname>: 完全な <acronym>MIME</acronym> 最終バウンダリ行を返します。
                    </para>
                </listitem>
            </itemizedlist>
        </para>
    </sect2>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->