Configuration à l'exécution

Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.

Options de configuration pour le mail

Nom	Défaut	Modifiable	Historique
mail.add_x_header	"0"	INI_PERDIR
mail.mixed_lf_and_crlf	"0"	INI_SYSTEM|INI_PERDIR	Ajouté dans PHP 8.2.4
mail.log	NULL	INI_SYSTEM|INI_PERDIR
mail.force_extra_parameters	NULL	INI_SYSTEM|INI_PERDIR
SMTP	"localhost"	INI_ALL
smtp_port	"25"	INI_ALL
sendmail_from	NULL	INI_ALL
sendmail_path	"/usr/sbin/sendmail -t -i"	INI_SYSTEM

Pour plus de détails sur les modes INI_*, reportez-vous à Où une directive de configuration peut être modifiée.

Voici un éclaircissement sur l'utilisation des directives de configuration.

mail.add_x_header bool

Ajoute un en-tête X-PHP-Originating-Script qui inclut l'UID du script, suivi par le nom du fichier.

mail.log string

Le chemin de l'historique de tous les appels à la fonction mail(). Les entrées de l'historique incluent le chemin complet vers le script, le numéro de la ligne, les adresses To ainsi que les en-têtes.

mail.mixed_lf_and_crlf bool

Permet de revenir à l'indicateur de fin de ligne pour les en-têtes de courrier électronique et les corps de message en LF (Line Feed), imitant le comportement non conforme de PHP 7. Il est fourni comme mesure de compatibilité pour certains Agents de transfert de courrier (MTA) non conformes qui échouent à traiter correctement CRLF (Retour chariot + Line Feed) comme indicateur de fin de ligne dans les en-têtes de courrier électronique et le contenu des messages.

mail.force_extra_parameters string

Permet de forcer l'ajout du paramètre spécifié en tant que paramètre supplémentaire pour sendmail. Ces paramètres prendront la place du cinquième paramètre de la fonction mail().

En plus du comportement par défaut pour INI_SYSTEM, cette valeur peut également être définie avec php_value dans httpd.conf (mais cela n'est pas recommandé).

smtp string

Sous Windows seulement : nom de l'hôte ou adresse IP du SMTP que PHP doit utiliser pour envoyer un mail avec la fonction mail().

smtp_port int

Sous Windows seulement : numéro de port à utiliser pour se connecter au serveur SMTP lors de l'envoi de mail avec la fonction mail(); par défaut, c'est 25.

sendmail_from string

Sous Windows seulement : valeur du champ "From:" qui doit être utilisée lors de l'envoi de mail via SMTP (uniquement sous Windows). Cette directive définira également l'en-tête "Return-Path:".

sendmail_path string

Localisation du programme sendmail : habituellement /usr/sbin/sendmail ou /usr/lib/sendmail. configure essaye de repérer la présence de sendmail par lui-même, et affecte ce résultat par défaut. En cas de problème de localisation, il est possible d'établir une nouvelle valeur par défaut ici.

Tout système n'utilisant pas sendmail doit établir cette directive à la valeur chemin du programme de substitution qui remplace le serveur de mail, si celui-ci existe. Par exemple, les utilisateurs de » Qmail peuvent la définir à /var/qmail/bin/sendmail ou /var/qmail/bin/qmail-inject.

qmail-inject ne requiert aucune option pour traiter correctement le mail.

Cette directive fonctionne également sous Windows. Si elle est définie, smtp, smtp_port et sendmail_from sont ignorés et la commande spécifiée est exécutée.