imap_mail_move

(PHP 4, PHP 5, PHP 7, PHP 8)

imap_mail_move — Verschiebt Nachrichten in ein anderes Postfach

Beschreibung

imap_mail_move(
    IMAP\Connection $imap,
    string $message_nums,
    string $mailbox,
    int $flags = 0
): bool

imap_mail_move() verschiebt die mit message_nums angegebenen Nachrichten in das Postfach mailbox. Es ist zu beachten, dass die Nachrichten in Wirklichkeit in das Postfach mailbox kopiert werden und die ursprünglichen Nachrichten zum Löschen markiert werden. Das bedeutet, dass die Nachrichten in mailbox neue UIDs zugewiesen bekommen.

Parameter-Liste

imap

Eine IMAP\Connection-Instanz.

message_nums

message_nums ist keine Liste von Nachrichtennummern, sondern ein Nachrichtenbereich (wie in » RFC2060 beschrieben).

mailbox

Das Zielpostfach, für weitere Informationen siehe imap_open()

Warnung

Die Übergabe von nicht vertrauenswürdigen Daten an diesen Parameter ist unsicher,falls imap.enable_insecure_rsh nicht deaktiviert ist.

flags

flags ist eine Bitmaske und kann zur Zeit nur eine Option enthalten:

  • CP_UID - die Nummern der Nachrichten sind UIDs

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.

Anmerkungen

Hinweis:

imap_mail_move() setzt für die Original-Nachricht ein Lösch-Flag. Um sie erfolgreich zu löschen, muss die Funktion imap_expunge() aufgerufen werden.

Siehe auch