documentation/manual/ja/module_specs/Zend_Mime.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <!-- EN-Revision: 20827 -->
   4 <sect1 id="zend.mime.mime">
   5     <title>Zend_Mime</title>
   6
   7     <sect2 id="zend.mime.mime.introduction">
   8         <title>導入</title>
   9
  10         <para>
  11             <classname>Zend_Mime</classname> は、マルチパート <acronym>MIME</acronym>
  12             メッセージを処理するためのサポートクラスです。
  13             <link linkend="zend.mail"><classname>Zend_Mail</classname></link> や
  14             <link linkend="zend.mime.message"><classname>Zend_Mime_Message</classname></link>、
  15             そして <acronym>MIME</acronym> サポートを必要とするその他のアプリケーションから使用されます。
  16         </para>
  17     </sect2>
  18
  19     <sect2 id="zend.mime.mime.static">
  20         <title>静的メソッドおよび定数</title>
  21
  22         <para>
  23             <classname>Zend_Mime</classname> は、<acronym>MIME</acronym> を処理するための以下のような静的ヘルパーメソッドを提供しています。
  24
  25             <itemizedlist>
  26                 <listitem>
  27                     <para>
  28                         <methodname>Zend_Mime::isPrintable()</methodname>:
  29                         指定した文字列の中に表示できない文字がなければ <constant>TRUE</constant> 、
  30                         それ以外の場合に <constant>FALSE</constant> を返します。
  31                     </para>
  32                 </listitem>
  33
  34                 <listitem>
  35                     <para>
  36                         <methodname>Zend_Mime::encode()</methodname>: 指定されたエンコードで文字列を エンコードします。
  37                     </para>
  38                 </listitem>
  39
  40                 <listitem>
  41                     <para>
  42                         <methodname>Zend_Mime::encodeBase64()</methodname>: 文字列を base64 でエンコードします。
  43                     </para>
  44                 </listitem>
  45
  46                 <listitem>
  47                     <para>
  48                         <methodname>Zend_Mime::encodeQuotedPrintable()</methodname>:
  49                         文字列を quoted-printable でエンコードします。
  50                     </para>
  51                 </listitem>
  52
  53                 <listitem>
  54                     <para>
  55                         <methodname>Zend_Mime::encodeBase64Header()</methodname>:
  56                         メールヘッダ用に文字列を base64 でエンコードします。
  57                     </para>
  58                 </listitem>
  59
  60                 <listitem>
  61                     <para>
  62                         <methodname>Zend_Mime::encodeQuotedPrintableHeader()</methodname>:
  63                         メールヘッダ用に文字列を quoted-printable でエンコードします。
  64                     </para>
  65                 </listitem>
  66             </itemizedlist>
  67         </para>
  68
  69         <para>
  70             <classname>Zend_Mime</classname> では、<acronym>MIME</acronym> メッセージでよく使われる定数を定義しています。
  71
  72             <itemizedlist>
  73                 <listitem>
  74                     <para>
  75                         <constant>Zend_Mime::TYPE_OCTETSTREAM</constant>: 'application/octet-stream'
  76                     </para>
  77                 </listitem>
  78
  79                 <listitem>
  80                     <para>
  81                         <constant>Zend_Mime::TYPE_TEXT</constant>: 'text/plain'
  82                     </para>
  83                 </listitem>
  84
  85                 <listitem>
  86                     <para>
  87                         <constant>Zend_Mime::TYPE_HTML</constant>: 'text/html'
  88                     </para>
  89                 </listitem>
  90
  91                 <listitem>
  92                     <para>
  93                         <constant>Zend_Mime::ENCODING_7BIT</constant>: '7bit'
  94                     </para>
  95                 </listitem>
  96
  97                 <listitem>
  98                     <para>
  99                         <constant>Zend_Mime::ENCODING_8BIT</constant>: '8bit'
 100                     </para>
 101                 </listitem>
 102
 103                 <listitem>
 104                     <para>
 105                         <constant>Zend_Mime::ENCODING_QUOTEDPRINTABLE</constant>: 'quoted-printable'
 106                     </para>
 107                 </listitem>
 108
 109                 <listitem>
 110                     <para>
 111                         <constant>Zend_Mime::ENCODING_BASE64</constant>: 'base64'
 112                     </para>
 113                 </listitem>
 114
 115                 <listitem>
 116                     <para>
 117                         <constant>Zend_Mime::DISPOSITION_ATTACHMENT</constant>: 'attachment'
 118                     </para>
 119                 </listitem>
 120
 121                 <listitem>
 122                     <para>
 123                         <constant>Zend_Mime::DISPOSITION_INLINE</constant>: 'inline'
 124                     </para>
 125                 </listitem>
 126
 127                 <listitem>
 128                     <para>
 129                         <constant>Zend_Mime::MULTIPART_ALTERNATIVE</constant>: 'multipart/alternative'
 130                     </para>
 131                 </listitem>
 132
 133                 <listitem>
 134                     <para>
 135                         <constant>Zend_Mime::MULTIPART_MIXED</constant>: 'multipart/mixed'
 136                     </para>
 137                 </listitem>
 138
 139                 <listitem>
 140                     <para>
 141                         <constant>Zend_Mime::MULTIPART_RELATED</constant>: 'multipart/related'
 142                     </para>
 143                 </listitem>
 144             </itemizedlist>
 145         </para>
 146     </sect2>
 147
 148     <sect2 id="zend.mime.mime.instatiation">
 149         <title>Zend_Mime インスタンスの作成</title>
 150
 151         <para>
 152             <classname>Zend_Mime</classname> オブジェクトのインスタンスを作成する際に、
 153             <acronym>MIME</acronym> バウンダリが作成されます。それ以降にこのオブジェクトの
 154             (静的でない) メソッドがコールされるときには、このバウンダリが使用されます。
 155             文字列パラメータを指定してコンストラクタがコールされた場合は、
 156             その値が <acronym>MIME</acronym> バウンダリとして使用されます。指定されなかった場合は、
 157             ランダムな <acronym>MIME</acronym> バウンダリがコンストラクタのコール時に生成されます。
 158         </para>
 159
 160         <para>
 161             <classname>Zend_Mime</classname> オブジェクトには次のメソッドがあります。
 162
 163             <itemizedlist>
 164                 <listitem>
 165                     <para>
 166                         <methodname>boundary()</methodname>: <acronym>MIME</acronym> バウンダリ文字列を返します。
 167                     </para>
 168                 </listitem>
 169
 170                 <listitem>
 171                     <para>
 172                         <methodname>boundaryLine()</methodname>: 完全な <acronym>MIME</acronym> バウンダリ行を返します。
 173                     </para>
 174                 </listitem>
 175
 176                 <listitem>
 177                     <para>
 178                         <methodname>mimeEnd()</methodname>: 完全な <acronym>MIME</acronym> 最終バウンダリ行を返します。
 179                     </para>
 180                 </listitem>
 181             </itemizedlist>
 182         </para>
 183     </sect2>
 184 </sect1>
 185 <!--
 186 vim:se ts=4 sw=4 et:
 187 -->