# imap_mail_copy

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

imap_mail_copy — Copie les messages spécifiés dans une boîte aux lettres

### Description

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

Copie les messages email spécifiés par `message_nums` dans la boîte aux lettres spécifiée.

### Liste de paramètres

`imap`

  Une instance de IMAP\Connection.

`message_nums`

  `message_nums` est un intervalle, et pas seulement une liste de numéros de message (comme décrit dans la » RFC2060).

`mailbox`

  Le nom de la boîte aux lettres, voir la documentation de la fonction imap_open() pour plus de détails

  Avertissement

  Passer des données qui ne sont pas digne de confiance à ce paramètre est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.

`flags`

  `flags` est un masque, qui peut contenir une ou plusieurs des valeurs suivantes :

  - `CP_UID` - la séquence de nombre contient des UIDS
  - `CP_MOVE` - Efface les messages après copie. Si ce drapeau est défini, la fonction se comporte de manière identique à imap_mail_move().

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient.

### Historique

Version | Description
--- | ---
8.1.0 | La paramètre `imap` attend désormais une instance de IMAP\Connection ; auparavant, une resource `imap` était attendue.

### Voir aussi

- imap_mail_move() - Déplace des messages dans une boîte aux lettres