imap_mail_move
(PHP 4, PHP 5, PHP 7, PHP 8)
imap_mail_move — Verschiebt Nachrichten in ein anderes Postfach
Beschreibung
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_numsist keine Liste von Nachrichtennummern, sondern ein Nachrichtenbereich (wie in » RFC2060 beschrieben). -
mailbox -
Das Zielpostfach, für weitere Informationen siehe imap_open()
WarnungDie Übergabe von nicht vertrauenswürdigen Daten an diesen Parameter ist unsicher, falls imap.enable_insecure_rsh nicht deaktiviert ist.
-
flags -
flagsist 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 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.
