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

    VersionBeschreibung
    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

    To Top