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

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.mail.additional-headers">
    <title>Zusätzliche Kopfzeilen</title>

    <para>
        <classname>Zend_Mail</classname> bietet verschiedene Methode um zusätzliche Mail Header zu
        setzen:

        <itemizedlist>
            <listitem>
                <para>
                    <methodname>setReplyTo($email, $name=null)</methodname>: Setzt den Reply-To:
                    Header.
                </para>
            </listitem>

            <listitem>
                <para>
                    <methodname>setDate($date = null)</methodname>: Setzt den Date: Header.
                    Diese Methode verwendet standardmäßig den aktuellen Zeitpunkt. Man kann dieser
                    Methode auch einen Zeitpunkt, einen Datumsstring oder eine Instanz von
                    <classname>Zend_Date</classname> übergeben.
                </para>
            </listitem>

            <listitem>
                <para>
                    <methodname>setMessageId($id = true)</methodname>: Setzt den Message-Id: Header.
                    Diese Methode erzeugt standardmäßig automatisch eine Message ID. Oder man
                    übergibt der Methode einen eigenen Message ID String. Diese Methode ruft intern
                    <methodname>createMessageId()</methodname> auf.
                </para>
            </listitem>
        </itemizedlist>
    </para>

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

        <para>
            Wenn man den Return-Path in eigenen Mail setzen will, sollte man unter <link
                linkend="zend.mail.introduction.sendmail">Konfiguration des Sendmail
                Transports</link> nachsehen. Unglücklicherweise führt die
            <methodname>setReturnPath($email)</methodname> Methode dies nicht aus.
        </para>
    </note>

    <para>
        Weiters können eigene Mail Header gesetzt werden indem man die
        <methodname>addHeader()</methodname> Methode verwendet. Sie benötigt zwei Parameter welche
        den Namen und den Wert des Header Fields enthalten. Ein optionaler dritter Parameter
        zeigt an ob der Header nur einen oder mehrere Werte enthalten soll:
    </para>

    <example id="zend.mail.additional-headers.example-1">
        <title>Eine E-Mail Kopfzeile hinzufügen</title>

        <programlisting language="php"><![CDATA[
$mail = new Zend_Mail();
$mail->addHeader('X-MailGenerator', 'MeineCooleAnwendung');
$mail->addHeader('X-greetingsTo', 'Mom', true); // mehrer Werte
$mail->addHeader('X-greetingsTo', 'Dad', true);
]]></programlisting>
    </example>
</sect1>