Copia mensagens especificadas para uma caixa de correio

# imap_mail_copy

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

imap_mail_copy — Copia mensagens especificadas para uma caixa de correio

### Descrição

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

Copia mensagens de e-mail especificadas por `message_nums` para a caixa de correio especificada.

### Parâmetros

`imap`
  Uma instância de IMAP\Connection.
`message_nums`

  `message_nums` é um intervalo, não apenas números de mensagens (conforme descrito em » RFC2060).

`mailbox`

  O nome da caixa de correio, veja imap_open() para mais informações

  Aviso

  Passar dados não confiáveis para este parâmetro é inseguro, a menos que imap.enable_insecure_rsh esteja desabilitado.

`flags`

  `flags` é uma máscara de bits de uma ou mais das constantes a seguir:

  - `CP_UID` - os números de sequência contêm UIDS
  - `CP_MOVE` - Exclui as mensagens da caixa de correio atual após a cópia. Se este sinalizador estiver definido, a função se comporta de forma idêntica a imap_mail_move().

### Valor Retornado

Retorna `true` em caso de sucesso ou `false` em caso de falha.

### Registro de Alterações

Versão | Descrição
--- | ---
8.1.0 | O parâmetro `imap` agora espera uma instância de IMAP\Connection; anteriormente, um resource `imap` válido era esperado.

### Veja Também

- imap_mail_move() - Move mensagens especificadas para uma caixa de correio

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