Aller au contenu principal
Version: 26.0.9.0

smtp.yaml

Application de la configuration SMTP pour l'envoi de mail avec wp_mail().

Par défaut, l'environnement de développement est paramétré pour utiliser MailDev et l'environnement de production reste à définir.

env: dev
dev_domain: elementum.wsl
dev: # MAILDEV
    host: localhost
    user:
    password:
    secure:
    port: 1025
    # from_name: Elementum
    # from_email: dev@elementum.local

prod: # PROD SMTP
    host: smtp.gmail.com
    user:
    password:
    port: 465
    secure: ssl

Variables

  • env: environnement de développement
  • dev_domain: domaine autorisé pour utiliser réellement l'environnement dev
  • host: hôte SMTP
  • user: utilisateur SMTP
  • password: mot de passe SMTP
  • port: port SMTP
  • secure: protocole de sécurité SMTP
  • from_name: force le nom de l'expéditeur
  • from_email: force l'adresse email de l'expéditeur
attention

Le fait de forcer le nom et/ou l'adresse mail de l'expéditeur rendra totalement impossible de dynamiser par la suite

Sécuriser l'environnement avec dev_domain

Elementum détermine désormais le vrai environnement SMTP avec la règle suivante :

  • si env: dev et que HTTP_HOST === dev_domain, alors l'environnement dev est utilisé ;
  • sinon, Elementum force automatiquement l'environnement prod.

Cette protection évite d'envoyer des mails de test via MailDev sur un domaine non prévu (pré-prod, staging, prod clonée, etc.).

env: dev
dev_domain: elementum.wsl

Si vous ne définissez pas dev_domain, le comportement historique est conservé (env est utilisé tel quel).

MailDev

Pour installer MailDev facilement, il suffit de lancer la commande suivante :

npm install -g maildev

puis de lancer le serveur avec la commande suivante :

maildev

L'interface web de MailDev est accessible à l'adresse suivante : http://localhost:1080.
Le port SMTP par défaut est le 1025.