imap_mail_copy

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

imap_mail_copyКопирует сообщения в указанный почтовый ящик

Описание

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

Копирует заданные в параметре message_nums письма в указанный почтовый ящик.

Список параметров

imap

Экземпляр класса IMAP\Connection.

message_nums

message_nums - это диапазон, а не просто номера сообщений (как определено в » RFC2060).

mailbox

Имя почтового ящика. Более подробно читайте в разделе, посвящённом функции imap_open()

Внимание

Если imap.enable_insecure_rsh не отключён, то передача в этот параметр не проверенных данных не безопасна.

flags

flags - битовая маска одной или нескольких констант:

  • CP_UID - означает, что в первом параметре не номера сообщений, а их UID.
  • CP_MOVE - удалить оригинальные сообщения после копирования. Если этот флаг установлен, функция ведёт себя идентично функции imap_mail_move().

Возвращаемые значения

Возвращает true в случае успешного выполнения или false, если возникла ошибка.

Список изменений

Версия Описание
8.1.0 Параметр imap теперь ожидает экземпляр класса IMAP\Connection; раньше параметр ждал ресурс (resource) imap.

Смотрите также

  • imap_mail_move() - Перемещает указанные сообщения в указанный почтовый ящик