imap_append

(PHP 4, PHP 5)

imap_append — String als Nachricht in einem Postfach ablegen

Beschreibung

bool imap_append ( resource $imap_stream , string $mailbox , string $message [, string $options= NULL ] )

Der in message übergebene String wird als Nachricht an das Postfach mailbox angefügt.

Parameter-Liste

imap_stream

Eine von imap_open() zurückgegebene IMAP-Verbindung.

mailbox

Der Name des Postfachs, siehe imap_open() für nähere Informationen.

message

Die anzufügende Nachricht als String

Bei Verbindungen mit dem Cyrus IMAP server ist es zwingend erforderlich "\r\n" als Zeilenende zu benutzen, mit einem einfachen "n" schlägt die Operation fehl.

options

Wenn angegeben werden die in options gesetzten Optionen der Nachricht bei der Anlage gesetzt.

Rückgabewerte

Gibt bei Erfolg TRUE zurück, im Fehlerfall FALSE.

Beispiele

Beispiel #1 imap_append() Beispiel


<?php
$stream = imap_open("{imap.example.org}INBOX.Drafts", "username", "password");

$check = imap_check($stream);
echo "Msg Count before append: ". $check->Nmsgs . "\n";

imap_append($stream, "{imap.example.org}INBOX.Drafts"
                   , "From: me@example.com\r\n"
                   . "To: you@example.com\r\n"
                   . "Subject: test\r\n"
                   . "\r\n"
                   . "this is a test message, please ignore\r\n"
                   );

$check = imap_check($stream);
echo "Msg Count after append : ". $check->Nmsgs . "\n";

imap_close($stream);
?>