# imap_mail

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

imap_mail — Envoie un message mail

### Description

imap_mail(
string `$to`,
string `$subject`,
string `$message`,
?string `$additional_headers` = `null`,
?string `$cc` = `null`,
?string `$bcc` = `null`,
?string `$return_path` = `null`
): bool

imap_mail() permet d'envoyer des mails avec une gestion correcte des destinataires Cc et Bcc.

Les paramètres `to`, `cc` et `bcc` sont tous des chaînes et sont analysées comme des listes d'adresses » RFC822.

### Liste de paramètres

`to`

  Le destinataire

`subject`

  Le sujet du mail

`message`

  Le corps du mail ; voir la fonction imap_mail_compose().

`additional_headers`

  Une chaîne de caractères contenant les en-têtes additionnels à envoyer avec le mail

`cc`

`bcc`

  Les destinataires spécifiés dans le `bcc` recevront le mail mais sont exclus des en-têtes.

`return_path`

  Utiliser ce paramètre pour spécifier le chemin de retour en cas d'échec de délivrance du mail. C'est utile lorsque vous utilisez PHP comme client mail pour plusieurs utilisateurs.

### Valeurs de retour

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

### Historique

Version | Description
--- | ---
8.0.0 | `additional_headers`, `cc`, `bcc`, et `return_path` sont désormais nullable.

### Voir aussi

- mail() - Envoi de mail
- imap_mail_compose() - Crée un message MIME