Acorn Mail : une approche propre et testable pour configurer SMTP dans WordPress

Configurer l’envoi d’emails dans WordPress via SMTP, c’est souvent une petite dette technique qui grossit : un plugin différent selon les projets, des réglages à reproduire entre dev/staging/prod, et le jour où un email ne part pas… aucun retour exploitable.

Le problème n’est pas SMTP en soi, mais l’outillage autour : certains plugins sont peu fiables, parfois discutables côté sécurité, et il existe même des cas documentés de vulnérabilités dans l’écosystème des plugins SMTP (ex. CVE-2023-6875). Ajoute à ça des écrans “Test email sent!” qui ne disent rien quand ça échoue, et tu te retrouves à déboguer à l’aveugle.

C’est précisément là qu’Acorn Mail se positionne : une extension pour l’écosystème Roots/Acorn, pensée pour standardiser la configuration SMTP et surtout rendre le test d’envoi explicite via la CLI (Command Line Interface), en s’intégrant proprement au moteur d’email historique de WordPress : PHPMailer.

Acorn Mail, en deux idées simples

• Configurer SMTP via des variables d’environnement (approche 12-factor) : plus propre, plus portable, plus simple à versionner sans secrets.
• Activer un mode test via la CLI Acorn pour envoyer un email de test et afficher clairement les erreurs rencontrées pendant le processus.

Côté WordPress, l’intégration se fait en “branchant” automatiquement la configuration SMTP sur l’instance PHPMailer utilisée par WordPress, dès lors que les identifiants sont présents (non vides). En clair : tu déclares tes variables, et Acorn Mail fait le câblage.

Installation : via Composer (comme le reste de l’écosystème Roots)

Acorn Mail s’installe avec Composer, en complément d’Acorn :

composer require roots/acorn-mail

composer require roots/acorn-mail

Ce choix est cohérent avec une base Bedrock/Sage/Acorn : dépendances versionnées, déploiements reproductibles, et pas de “plugin zip” à manipuler selon les environnements.

Configuration SMTP : tout passe par des variables d’environnement

Une fois installé, l’essentiel se fait avec les variables d’environnement suivantes :

MAIL_HOST=
MAIL_PORT=
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_FROM_ADDRESS=
MAIL_FROM_NAME=

MAIL_HOST=
MAIL_PORT=
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_FROM_ADDRESS=
MAIL_FROM_NAME=

Dès que ces valeurs sont détectées (non vides), Acorn Mail configure automatiquement SMTP sur PHPMailer côté WordPress. Ça évite de reproduire des écrans de configuration, de stocker des secrets dans l’admin, et ça se marie très bien avec la séparation dev/staging/prod.

Configuration avancée : publier le fichier mail.php

Si tu as besoin d’aller plus loin qu’un simple mapping via .env, Acorn Mail permet de publier un fichier de configuration dédié :

wp acorn mail:config

wp acorn mail:config

Cette commande génère un mail.php que tu peux adapter pour des besoins plus spécifiques (tout ce qui dépasse la config minimale par variables).

Tester l’envoi : une commande CLI qui montre les erreurs

Le point souvent négligé dans les stacks WordPress : tester SMTP correctement. Acorn Mail propose une commande de test dédiée :

wp acorn mail:test [--to=]

wp acorn mail:test [--to=]

Tu peux envoyer un email de test à l’adresse fournie, et surtout obtenir un retour clair sur les erreurs rencontrées pendant la tentative d’envoi. Dans des environnements où l’email est souvent le premier truc qui casse (DNS, firewall, mauvais port, credentials expirés), cette visibilité change la donne.

Où ça s’intègre le mieux (et où ça aide vraiment)

• Stacks Roots (Bedrock/Acorn) où Composer et WP-CLI sont déjà des standards.
• Projets multi-environnements (dev/staging/prod) où tu veux éviter les divergences de config SMTP.
• Équipes qui veulent bannir les plugins SMTP “boîte noire” et garder une surface d’attaque plus faible.
• CI/CD : pouvoir tester rapidement un envoi (ou au moins valider la config) via des commandes outillées.

Résumé

1. Acorn Mail vise à simplifier et fiabiliser la configuration SMTP dans WordPress en s’appuyant sur Acorn.
2. La configuration se fait via variables d’environnement, puis Acorn Mail configure automatiquement PHPMailer.
3. Une config avancée est possible via publication d’un mail.php.
4. Le gros plus côté dev : une commande de test wp acorn mail:test qui affiche proprement les erreurs.