mailEnvoi de mail
&reftitle.description;
boolmailstringtostringsubjectstringmessagearraystringadditional_headers[]stringadditional_params""
Envoie un mail.
&reftitle.parameters;
to
Le ou les destinataires du mail.
Le formatage de cette chaîne doit correspondre avec la
RFC 2822. Voici quelques exemples :
destinataire@example.comdestinataire@example.com, autre_destinataire@example.comDestinataire <destinataire@example.com>Destinataire <destinataire@example.com>, Autre destinataire <autre_destinataire@example.com>subject
Sujet du mail à envoyer.
Le sujet doit satisfaire à la RFC 2047.
message
Message à envoyer.
Chaque ligne doit être séparée par un caractère CRLF
(\r\n). Les lignes ne doivent pas comporter plus de 70 caractères.
(Windows uniquement) Lorsque PHP discute directement avec un serveur
SMTP, si un point est trouvé en début de ligne, il sera supprimé.
Pour éviter ce comportement, remplacez ces occurrences par un double
point.
]]>
additional_headers (optionnel)String ou array à insérer à la fin des en-têtes du mail.
Ce paramètre est typiquement utilisé pour ajouter des en-têtes supplémentaires
(From, Cc et Bcc). Les en-têtes supplémentaires doivent être
séparés par un caractère CRLF (\r\n).
Si des données externes sont utilisées pour composer cet en-tête, elles doivent
être d'abord nettoyées afin de ne pas injecter des données non désirées
dans les en-têtes.
Si un array est passé, ses clés sont les noms d'en-tête et
ses valeurs sont les valeurs d'en-tête respectives.
Avant PHP 5.4.42 et 5.5.27, respectivement,
additional_headers n'avait pas de protection
d'injection en-tête de messagerie. Par conséquent, les utilisateurs
doivent s'assurer que les en-têtes spécifiés sont sûrs et contiennent
uniquement des en-têtes. C'est à dire ne jamais démarrer le corps du
courrier en mettant plusieurs sauts.
Lors de l'envoi d'un mail, le mail doit
contenir un en-tête From. Il peut être
défini par le paramètre additional_headers,
ou un par défaut peut être défini dans le &php.ini;.
Ne pas faire ceci causera un message d'erreur similaire à
Warning: mail(): "sendmail_from" not
set in php.ini or custom "From:" header missing.
L'en-tête From définit également l'en-tête
Return-Path lors de l'envoi direct via SMTP (Windows
uniquement).
Si le message n'est pas reçu, essayez d'utiliser uniquement un caractère
LF (\n).
Quelques agents de transfert de mail Unix (par exemple
qmail)
remplacent le caractère LF par le
caractère CRLF automatiquement
(ce qui revient à doubler le caractère CR
si le caractère CRLF est utilisé).
Ceci doit être un dernier recours car cela ne correspond pas
à la RFC 2822.
additional_params (optionnel)
Le paramètre additional_params
peut être utilisé pour passer des drapeaux additionnels comme options
à la ligne de commande configurée pour être utilisée pour envoyer les
mails en utilisant le paramètre de configuration sendmail_path.
Par exemple, ceci peut être utilisé pour définir l'adresse
d'expéditeur de l'enveloppe lors de l'utilisation de sendmail avec l'option
-f.
Ce paramètre est échappé par la fonction escapeshellcmd en interne
afin de prévenir l'exécution d'une commande. La fonction escapeshellcmd
empêche l'exécution d'une commande, mais autorise l'ajout de paramètres supplémentaires.
Pour des raisons de sécurité, il est recommandé pour l'utilisateur de nettoyer ce paramètre
afin d'éviter l'ajout de paramètres non désirés à la commande shell.
Depuis que la fonction escapeshellcmd est appliquée automatiquement,
quelques caractères autorisés dans les adresses emails par les RFCs d'internet ne peuvent
plus être utilisés. La fonction mail ne peut autoriser ces caractères,
aussi, dans les programme où leur utilisation est nécessaire, vous devriez utiliser
une méthode alternative pour l'envoi des emails (comme l'utilisation d'un framework
ou d'une librairie.
L'utilisateur sous lequel tourne le serveur web doit être ajouté en tant qu'utilisateur de confiance
dans la configuration de sendmail afin que l'en-tête X-Warning
ne soit pas ajouté au message lorsque l'expéditeur de l'enveloppe (-f) est
défini en utilisant cette méthode. Pour les utilisateurs de sendmail, ce fichier est
/etc/mail/trusted-users.
&reftitle.returnvalues;
Retourne &true; si le mail a été accepté pour livraison, &false; sinon.
Il est important de noter que ce n'est pas parce que le mail a été accepté pour livraison
qu'il arrivera à destination.
&reftitle.changelog;
&Version;&Description;7.2.0
Le paramètre additional_headers accepte maintenant
les array.
&reftitle.examples;
Envoi d'un mail
Utilisation de la fonction mail pour envoyer un mail simple :
]]>
Envoi d'un mail avec des en-têtes supplémentaires
L'ajout d'en-têtes simples, spécifiant au MUA les adresses
"From" et "Reply-To" :
]]>
Envoi d'un mail avec un <type>array</type> d'en-têtes supplémentaires
Cet exemple envoie le même courrier que l'exemple ci-dessus, mais passe
les en-têtes supplémentaires en tant que tableau (disponible depuis PHP
7.2.0).
'webmaster@example.com',
'Reply-To' => 'webmaster@example.com',
'X-Mailer' => 'PHP/' . phpversion()
);
mail($to, $subject, $message, $headers);
?>
]]>
Envoi d'un mail avec un paramètre de ligne de commande additionnel
Le paramètre additional_params
peut être utilisé pour passer un paramètre additionnel au programme configuré
à être utilisé pour envoyer les mails en utilisant sendmail_path.
]]>
Envoi de mail HTML
Il est également possible d'envoyer des mails HTML avec la fonction
mail.
Calendrier des anniversaires pour Août