Acorn Mail: SMTP su WordPress senza plugin fragili (e con test via CLI)

Chiunque abbia dovuto rendere “affidabile” l’invio email su WordPress lo sa: tra differenze di ambiente, credenziali che cambiano, firewall, porte bloccate e plugin SMTP che fanno da scatola nera, finisci facilmente a perdere tempo su un problema che dovrebbe essere banale.

In più, il quadro non è sempre rassicurante: i plugin SMTP non solo possono essere instabili, ma possono anche introdurre superfici d’attacco (un esempio citato spesso in questo contesto è la vulnerabilità CVE-2023-6875). Anche quando tutto sembra configurato correttamente, “testare le credenziali” diventa frustrante: pochi log, messaggi d’errore vaghi, e nessun flusso davvero chiaro per capire cosa sta succedendo.

Da qui l’idea di Acorn Mail, un package open source dell’ecosistema Roots pensato per semplificare configurazione e test SMTP in progetti WordPress che usano Acorn (il framework/bridge che porta un’esperienza più moderna e “Laravel-like” nello sviluppo WordPress, con comandi WP-CLI dedicati).

Cos’è Acorn Mail e cosa risolve (davvero)

Acorn Mail è un pacchetto installabile via Composer che punta a due obiettivi pratici:

• Configurazione SMTP più prevedibile e portabile tra ambienti, usando variabili d’ambiente (env).
• Un comando CLI per inviare una mail di test e mostrare in modo pulito gli errori lungo la pipeline di invio.

Sotto al cofano, quando le credenziali sono presenti (non vuote), Acorn Mail si aggancia automaticamente all’istanza di PHPMailer di WordPress e la configura per usare SMTP. In pratica: niente “settaggi” dispersi in una UI di plugin e meno magia difficile da debuggare.

Installazione: un Composer require e sei operativo

Acorn Mail si installa affiancandolo ad Acorn tramite Composer:

composer require roots/acorn-mail

composer require roots/acorn-mail

Una volta installato, la configurazione base passa dalle classiche variabili d’ambiente. Quelle supportate sono:

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=

Configurazione avanzata: pubblicare il file mail.php

Se ti serve un controllo più fine rispetto alle sole env, Acorn Mail prevede la pubblicazione del file di configurazione mail.php tramite un comando dedicato di Acorn:

wp acorn mail:config

wp acorn mail:config

Questo passaggio è utile quando vuoi rendere la configurazione più esplicita o quando il progetto richiede opzioni aggiuntive rispetto alla configurazione minima.

Il punto forte: test SMTP via CLI (con errori leggibili)

Il “pain point” più grosso, nella pratica, è capire perché l’invio fallisce. Acorn Mail include un comando per inviare una mail di test:

wp acorn mail:test [--to=]

wp acorn mail:test [--to=]

L’idea è semplice ma estremamente efficace: specifichi un destinatario (con --to=) e il comando prova a spedire la mail mostrando in output gli errori che emergono durante il processo. Questo rende molto più rapido isolare problemi tipici come host errato, porta sbagliata, credenziali non valide o handshake TLS che non va a buon fine.

Quando ha senso adottarlo in un progetto WordPress

Acorn Mail è particolarmente sensato se lavori già con lo stack Roots/Acorn e vuoi:

• Ridurre la dipendenza da plugin SMTP generici (e dai loro pannelli di configurazione).
• Tenere le credenziali fuori dal database e più allineate alle pratiche DevOps.
• Avere un flusso ripetibile per testare l’invio email durante setup, deploy o troubleshooting.

In generale, sposta l’invio email verso una configurazione più “da applicazione”, dove i parametri stanno negli env e la diagnostica passa da strumenti da riga di comando invece che da tentativi alla cieca nel back-office.

Riferimenti ufficiali

Repository e documentazione del progetto: Acorn Mail.