---
title: "Acorn Mail: SMTP su WordPress senza plugin fragili (e con test via CLI)"
url: "https://helloblog.io/it/acorn-mail-smtp-wordpress-test-cli/"
date: "2024-03-19"
modified: "2026-01-20"
author: "Marco Bianchi"
language: "it_IT"
categories: ["Ecosistema WordPress"]
tags: ["Acorn", "CLI", "Roots", "SMTP", "WordPress"]
featured_image: "https://helloblog.io/app/uploads/sites/6/2026/01/featured-6-1024x572.jpg"
excerpt: "Configurare SMTP su WordPress tra dev, staging e produzione spesso è più complicato del previsto, soprattutto quando ti affidi a plugin opachi. Acorn Mail propone un approccio più pulito: configurazione via env e un comando CLI per testare l’invio con errori leggibili."
---

# 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](https://nvd.nist.gov/vuln/detail/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
```

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=
```

#### Perché env?

Nel workflow moderno (local → staging → produzione) le variabili d’ambiente ti permettono di cambiare provider/credenziali senza toccare codice o database, e senza trascinarti dietro configurazioni “a mano” tra installazioni.

## 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
```

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=]
```

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.

#### Nota operativa

Acorn Mail interviene su `PHPMailer` solo quando le variabili di configurazione risultano presenti (non vuote). Se il test non sembra usare SMTP, la prima cosa da verificare è che le env siano caricate correttamente nell’ambiente in cui stai eseguendo WP-CLI.

## 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](https://github.com/roots/acorn-mail)**.

## Riferimenti / Fonti

- [Announcing Acorn Mail](https://roots.io/announcing-acorn-mail/)
- [roots/acorn-mail](https://github.com/roots/acorn-mail)
- [CVE-2023-6875 Detail](https://nvd.nist.gov/vuln/detail/CVE-2023-6875)