imap_mail_move
(PHP 4, PHP 5, PHP 7, PHP 8)
imap_mail_move — Переміщує вказані повідомлення до вказаної поштової скриньки
Опис
imap_mail_move( IMAP\Connection $imap, string $message_nums, string $mailbox, int $flags = 0): bool
Переміщує листи, задані у параметрі message_nums
у вказаний у параметрі mailbox
Поштова скринька. Зверніть увагу, що поштові повідомлення фактично копіюються у ящик mailbox
, а вихідні повідомлення позначаються для видалення. Це означає, що повідомлення в ящиках mailbox
призначаються нові UID.
Список параметрів
imap
Екземпляр IMAP\Connection
message_nums
message_nums
- це діапазон, а не просто номери повідомлень (як визначено в » RFC2060
mailbox
Ім'я поштової скриньки. Докладніше читайте у розділі, присвяченому функції imap_open()
Увага
Якщо imap.enable_insecure_rsh не вимкнено, то передача в цей параметр не перевірених даних не безпечна
flags
flags
- бітова маска, яка може приймати лише одне значення:
- **
CP_UID
**- означає, що в першому параметрі не номери повідомлень, а їх UID
Значення, що повертаються
Повертає true
у разі успішного виконання або **false
**в случае возникновения ошибки.
список змін
Версия | Опис |
---|---|
8.1.0 | Параметрimap тепер чекає екземпляр IMAP\Connection; раніше очікувався ресурс (resourceimap |
Примітки
Зауваження :
Функцияimap_mail_move() позначає оригінальне повідомлення прапором видалення, тому не забудьте після неї викликати функцію imap_expunge()
Дивіться також
- imap_mail_copy() - Копіює повідомлення у вказану поштову скриньку