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

# imap_mail_copy

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

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

### Описание

function 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() - Перемещает указанные сообщения в указанный почтовый ящик

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open