(PHP 4, PHP 5, PHP 7)
imap_append — String als Nachricht in einem Postfach ablegen
$imap_stream
, string $mailbox
, string $message
[, string $options
= NULL
[, string $internal_date
= NULL
]] ) : bool
Der in message
übergebene String wird als
Nachricht an das Postfach mailbox
angefügt.
imap_stream
Eine von imap_open() zurückgegebene IMAP-Verbindung.
mailbox
Der Name des Postfachs, siehe imap_open() für nähere Informationen.
Passing untrusted data to this parameter is insecure, unless imap.enable_insecure_rsh is disabled.
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.
Gibt bei Erfolg TRUE
zurück. Im Fehlerfall wird FALSE
zurückgegeben.
Version | Beschreibung |
---|---|
5.3.2 | INTERNALDATE Unterstützung zu imag_append hinzugefügt. |
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: [email protected]\r\n"
. "To: [email protected]\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);
?>