documentation/manual/ja/module_specs/Zend_Mail-AdditionalHeaders.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <!-- EN-Revision: 20819 -->
   4 <sect1 id="zend.mail.additional-headers">
   5     <title>追加のヘッダ</title>
   6
   7     <para>
   8         <classname>Zend_Mail</classname> は追加のメールヘッダを設定するためのメソッドをいくつか提供します。
   9
  10         <itemizedlist>
  11             <listitem>
  12                 <para>
  13                     <methodname>setReplyTo($email, $name=null)</methodname>: Reply-To: ヘッダを設定します。
  14                 </para>
  15             </listitem>
  16
  17             <listitem>
  18                 <para>
  19                     <methodname>setDate($date = null)</methodname>: Date: ヘッダを設定します。
  20                     既定ではこのメソッドは現在のタイムスタンプを使用します。
  21                     または、このメソッドにタイムスタンプ、日付文字列または <classname>Zend_Date</classname>
  22                     インスタンスを渡せます。
  23                 </para>
  24             </listitem>
  25
  26             <listitem>
  27                 <para>
  28                     <methodname>setMessageId($id = true)</methodname>: Message-Id: ヘッダを設定します。
  29                     既定ではこのメソッドは自動的にメッセージ ID を生成できます。
  30                     または、このメソッドにメッセージ ID 文字列を渡せます。
  31                     このメソッドは内部的に <methodname>createMessageId()</methodname> を呼び出します。
  32                 </para>
  33             </listitem>
  34         </itemizedlist>
  35     </para>
  36
  37     <note>
  38         <title>Return-Path</title>
  39
  40         <para>
  41             もしメールに Return-Path を設定する場合は、<link linkend="zend.mail.introduction.sendmail"
  42                 >sendmail トランスポートの設定</link>をご覧ください。
  43             残念ながら、 <methodname>setReturnPath($email)</methodname> メソッドはこの目的を果たしません。
  44         </para>
  45     </note>
  46
  47     <para>
  48         さらに、 <methodname>addHeader()</methodname> メソッドを使用して、
  49         任意のヘッダを指定できます。ヘッダフィールドの名前、
  50         そして設定する値の 2 つのパラメータが必須となります。
  51         3 番目のパラメータはオプションで、ヘッダが複数の値をとるかどうかを指定します。
  52     </para>
  53
  54     <example id="zend.mail.additional-headers.example-1">
  55         <title>メールヘッダの追加</title>
  56
  57         <programlisting language="php"><![CDATA[
  58 $mail = new Zend_Mail();
  59 $mail->addHeader('X-MailGenerator', 'MyCoolApplication');
  60 $mail->addHeader('X-greetingsTo', 'Mom', true); // 複数の値
  61 $mail->addHeader('X-greetingsTo', 'Dad', true);
  62 ]]></programlisting>
  63     </example>
  64
  65 </sect1>
  66 <!--
  67 vim:se ts=4 sw=4 et:
  68 -->