Hängt eine String-Nachricht an ein Postfach an

Beschreibung

imap_append(
    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

Warnung

Die Ü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 options gesetzten Optionen auch ins Postfach folder geschrieben.

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 gültige `imap`-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);
?>