6.17 Mail
6 Référence des fonctions
Manuel PHP
. Introduction
. Pré-requis
. Installation
. Configuration à l'exécution
. Types de ressources
. Constantes pré-définies
. ezmlm_hash
->mail
|
6.17.8 mail()Envoi un mail[ Exemples avec mail ] PHP 3, PHP 4, PHP 5
bool
mail (
string
to
,
string
subject
,
string
message
,
string
additional_headers
,
string
additional_parameters
)
Envoi un mail.
-
to
-
Le ou les destinataires du mail.
Le formattage de cette chaîne doit correspondre avec la
RFC 2822 . Voici quelques exemples :
- utilisateur@example.com
- utilisateur.com, autre_utilisateur@example.com
- Utilisateur <utilisateur@example.com>
- Utilisateur <utilisateur@example.com>, Another User <anotheruser@example.com>
-
subject
-
Sujet du mail à envoyer.
| Attention | |
Il ne doit comporter aucun caractère de nouvelle ligne sinon, le mail
risque de ne pas être envoyé correctement.
|
-
message
-
Message à envoyer.
Chaque ligne doit être séparée par un caractère
LF
(
\n
). Les lignes ne doit pas comporter plus de 70 caractères.
| Attention | |
(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 occurences par un double
point.
<?php
$text = str_replace("\n.", "\n..", $text);
?>
|
-
additional_headers
(optionnel)
-
CHaîne à 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
).
| Note | |
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
.
|
| Note | |
Si le message n'est pas reçu, essayez d'utiliser uniquement un caractère
LF
(
\n
).
Quelques agents de transfert de mail Unix de mauvaise qualité
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_parameters
(optionnel)
-
Le paramètre
additional_parameters
peut être utilisé pour passer des paramètres additionnels au programme
configuré à être utilisé pour envoyer les mails en utilisant le paramètre
de configuration
sendmail_path
.
Par exemple, ceci peut être utilisé pour définir l'enveloppe de l'adresse
de l'expéditeur lors de l'utilisation de sendmail avec l'option
-f
.
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'enveloppe de l'expéditeur (-f) est
défini en utilisant cette méthode. Pour les utilisateurs de sendmail, ce fichier est
/etc/mail/trusted-users
.
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.
| Version |
Description |
| 4.3.0 (Windows uniquement) |
Tous les en-têtes personnalisés (comme From, Cc, Bcc et Date) sont
supportés et ne sont pas sensibles à la casse.
(Parce que les en-têtes personnalisés ne sont pas interprétés par le MTA
dans un premir temps mais analysés par PHP, PHP 4.3 supporte uniquement
l'en-tête Cc et est sensible à la casse).
|
| 4.2.3 |
Le paramètre
additional_parameters
est désactivé dans le
safe_mode et la fonction
mail
affichera un message d'alerte et
retournera
FALSE
lors de son utilisation.
|
| 4.0.5 |
Le paramètre
additional_parameters
a été ajouté.
|
| 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 paramètre de ligne de commande additionnel. | |
Le paramètre
additional_parameters
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
.
|
| Note | |
L'implémentation de la fonction
mail
sous Windows
diffère de manière significative avec l'implémentation Unix. Tout d'abord, il n'utilise
pas un binaire local pour composer les messages mais opère uniquement et
directement sur les sockets, ce qui signifie qu'un
MTA
est nécessairement à l'écoute sur un socket du réseau (qui peut être soit
sur le réseau local ou sur une machine distante).
Deuxièmement, les en-têtes personnalisés comme
From:
,
Cc:
,
Bcc:
et
Date:
ne sont
pas
interprétés par le
MTA
dans un premier temps, mais sont analysés par PHP.
De plus, le paramètre
to
ne doit pas être une adresse
sous la forme "Quelque chose <quelqu_un@example.com>".
La commande mail n'analysera pas correctement ceci lors de la discussion
avec le MTA.
|
| Note | |
Les mails avec des pièces jointes et des types spéciaux de contenus (e.g. HTML)
peuvent être envoyés en utilisant cette fonction. Ceci est accompli via
MIME-encoding - pour plus d'informations, lisez cet
article de Zend ou les
classes PEAR Mime .
|
| Note | |
Il est important de noter que la fonction
mail
n'est pas conseillée pour traiter de gros volumes de mails dans une boucle.
Cette fonction ouvre et ferme un socket SMTP pour chaque mail, ce qui n'est
pas très efficace.
Pour envoyer de gros volumes de mails, reportez-vous aux paquets
PEAR::Mail et
PEAR::Mail_Queue .
|
|