    MAIL -> boolean addheader ( string name, string value [, string charset [, string encoding ]] )

    Return TRUE if has been successfully added, FALSE if not.

    Default values are:
    string charset: utf-8
    string encoding: quoted-printable

    string encoding possible values are: quoted-printable or base64

    The most important values of header (see the list) can not be set.
    This values are automatically build or you can use a function to set it.

    List of headers name that can NOT be set using this function:
     Subject, From, To, Cc, Bcc, Date, Content-Type,
     Content-Transfer-Encoding, Content-Disposition, Message-ID,
     X-Mailer, X-Priority, X-MSMail-Priority, X-MimeOLE, MIME-Version

    Notice: you can add multiple header values with the same name.

    Example (verification):

    $m = new MAIL;

    // add "X-Whatever" mail header value
    $h = $m->AddHeader('X-Whatever', 'the value');

    echo $h ? 'added' : 'error';

    Example (deprecated):

    $m = new MAIL;

    // add "X-Whatever" mail header value, charset and encoding
    $m->Header[] = array(
    'name'     => 'X-Whatever', // required
    'value'    => 'the value', // required
    'charset'  => 'utf-8', // optional
    'encoding' => 'base64' // optional
    );
    // add another "X-Whatever" mail header value
    $m->Header[] = array('name' => 'X-Whatever', 'value' => 'the second value');

    See Also: MAIL->DelHeader()

    [ Comments ]

    Last update: Tuesday, October 23, 2007