imap_append
(PHP 4, PHP 5, PHP 7, PHP 8)
imap_append — Hängt eine String-Nachricht an ein Postfach an
Beschreibung
IMAP\Connection
$imap,string
$folder,string
$message,?string
$options = null,?string
$internal_date = null): bool
Der in message übergebene String wird als Nachricht
an das Postfach folder angefügt.
Parameter-Liste
-
imap -
Eine IMAP\Connection-Instanz.
-
folder -
Der Name des Postfachs, siehe imap_open() für nähere Informationen
WarnungDie Übergabe von nicht vertrauenswürdigen Daten an diesen Parameter ist unsicher, falls imap.enable_insecure_rsh nicht deaktiviert ist.
-
message -
Die anzufügende Nachricht als String
Bei Verbindungen mit dem Cyrus-IMAP-Server ist es zwingend erforderlich, "\r\n" als Zeilenende zu verwenden. Mit einem einfachen "\n" schlägt die Operation fehl.
-
options -
Wenn angegeben, werden die in
optionsgesetzten Optionen auch ins Postfachfoldergeschrieben. -
internal_date -
Wenn dieser Parameter angegeben wird, wird das INTERNALDATE für die hinzugefügte Nachricht gesetzt. Der Parameter sollte ein Datumsstring sein, der den rfc2060-Spezifikationen für einen date_time-Wert entspricht.
Rückgabewerte
Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.
Changelog
| Version | Beschreibung |
|---|---|
| 8.1.0 |
Der Parameter imap erwartet nun eine
IMAP\Connection-Instanz; vorher wurde eine Ressource
erwartet.
|
| 8.0.0 |
options und internal_date
sind jetzt nullable (akzeptieren den null-Wert).
|
Beispiele
Beispiel #1 imap_append()-Beispiel
<?php
$imap = imap_open("{imap.example.org}INBOX.Drafts", "username", "password");
$check = imap_check($imap);
echo "Anzahl der Nachrichten vor dem Anhängen: ". $check->Nmsgs . "\n";
imap_append($imap, "{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($imap);
echo "Anzahl der Nachrichten nach dem Anhängen: ". $check->Nmsgs . "\n";
imap_close($imap);
?>
