PHP-Handbuch: String als Nachricht in einem Postfach ablegen

Beschreibung

bool imap_append ( resource $imap_stream , string $mailbox , string $message [, string $options = NULL [, string $internal_date = 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.

internal_date

Wenn dieser Parameter angegeben wird, wird das INTERNALDATE für die hinzugefügte Nachricht gesetzt. Der Parameter sollte eine Datumszeichenkette sein, die konform zu den RFC2060 Spezifikationen für data_time Werte ist.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Changelog

Version	Beschreibung
5.3.2	INTERNALDATE Unterstützung zu imag_append hinzugefügt.

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);
?>