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

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 24249 -->
<sect1 id="zend.mail.additional-headers">
    <title>追加のヘッダ</title>

    <para>
        <classname>Zend_Mail</classname> は追加のメールヘッダを設定するためのメソッドをいくつか提供します。

        <itemizedlist>
            <listitem>
                <para>
                    <methodname>setReplyTo($email, $name=null)</methodname>: Reply-To: ヘッダを設定します。
                </para>
            </listitem>

            <listitem>
                <para>
                    <methodname>setDate($date = null)</methodname>: Date: ヘッダを設定します。
                    既定ではこのメソッドは現在のタイムスタンプを使用します。
                    または、このメソッドにタイムスタンプ、日付文字列または <classname>Zend_Date</classname>
                    インスタンスを渡せます。
                </para>
            </listitem>

            <listitem>
                <para>
                    <methodname>setMessageId($id = true)</methodname>: Message-Id: ヘッダを設定します。
                    既定ではこのメソッドは自動的にメッセージ ID を生成できます。
                    または、このメソッドにメッセージ ID 文字列を渡せます。
                    このメソッドは内部的に <methodname>createMessageId()</methodname> を呼び出します。
                </para>
            </listitem>
        </itemizedlist>
    </para>

    <note>
        <title>Return-Path</title>

        <para>
            もしメールに Return-Path を設定する場合は、<link linkend="zend.mail.introduction.sendmail"
                >sendmail トランスポートの設定</link>をご覧ください。
            残念ながら、 <methodname>setReturnPath($email)</methodname> メソッドはこの目的を果たしません。
        </para>
    </note>

    <para>
        さらに、 <methodname>addHeader()</methodname> メソッドを使用して、
        任意のヘッダを指定できます。ヘッダフィールドの名前、
        そして設定する値の 2 つのパラメータが必須となります。
        3 番目のパラメータはオプションで、ヘッダが複数の値をとるかどうかを指定します。
    </para>

    <example id="zend.mail.additional-headers.example-1">
        <title>メールヘッダの追加</title>

        <programlisting language="php"><![CDATA[
$mail = new Zend_Mail();
$mail->addHeader('X-MailGenerator', 'MyCoolApplication');
$mail->addHeader('X-greetingsTo', 'Mom', true); // 複数の値
$mail->addHeader('X-greetingsTo', 'Dad', true);
]]></programlisting>
    </example>

</sect1>
<!--
vim:se ts=4 sw=4 et:
-->