---
title: "Acorn Mail: SMTP in WordPress eindelijk voorspelbaar (met Acorn CLI)"
url: "https://helloblog.io/nl/acorn-mail-smtp-wordpress-acorn-cli/"
date: "2024-03-19"
modified: "2026-01-20"
author: "Naomi Wijngaard"
language: "nl_NL"
categories: ["WordPress Ecosysteem"]
tags: ["Acorn", "PHPMailer", "Roots", "SMTP", "WordPress"]
featured_image: "https://helloblog.io/app/uploads/sites/7/2026/01/featured-6-1024x572.jpg"
excerpt: "SMTP instellen in WordPress voelt vaak als gokken: het werkt lokaal, faalt op staging en geeft in productie nul feedback. Acorn Mail pakt dat anders aan met omgeving-variabelen, een nette PHPMailer-hook en een CLI-commando om je mailsetup echt te testen."
---

# Acorn Mail: SMTP in WordPress eindelijk voorspelbaar (met Acorn CLI)

Als je WordPress-sites bouwt in meerdere omgevingen (lokaal, staging, productie), dan ken je de SMTP-pijn: één plugin doet het ‘meestal’, een andere is lastig te debuggen, en uiteindelijk kom je er pas achter dat mail faalt wanneer een klant geen reset-link ontvangt. Daarbovenop komt nog dat SMTP-plugins niet alleen onvoorspelbaar kunnen zijn, maar soms ook een minder fijn security-profiel hebben — inclusief bekende kwetsbaarheden in het ecosysteem.

Roots introduceert daarom **[Acorn Mail](https://github.com/roots/acorn-mail)**: een package dat SMTP-configuratie en vooral het *testen* ervan in een WordPress-applicatie stroomlijnt. Het idee is simpel: configureer via environment variables en gebruik Acorn’s CLI (command line interface) om gericht een testmail te versturen met duidelijke foutoutput.

## Wat is Acorn Mail precies?

Acorn Mail is een add-on voor het Roots Acorn-ecosysteem. In plaats van een klassieke WordPress SMTP-plugin die via wp-admin wordt ingesteld, leunt Acorn Mail op **omgeving-variabelen** (bijvoorbeeld in je `.env`) en integreert het rechtstreeks met WordPress’ mailstack via **PHPMailer** (de library die WordPress gebruikt om mail te versturen).

Zodra er mail-credentials aanwezig zijn (dus niet leeg), haakt Acorn Mail automatisch in op de WordPress `PHPMailer`-instantie en zet SMTP voor je klaar. Geen extra UI, geen verborgen opties per omgeving, maar een configuratie die past bij moderne deployment-flows.

#### Waarom dit relevant is voor teams

Configuratie via environment variables is doorgaans beter te automatiseren (CI/CD), beter te scheiden per omgeving en makkelijker te reviewen dan instellingen die in de database of wp-admin verdwijnen.

## Installatie via Composer (zoals je het wilt in Roots-projecten)

Acorn Mail installeer je naast Acorn met Composer:

```
composer require roots/acorn-mail
```

Hierna is de basisopzet vooral een kwestie van het zetten van de juiste variabelen.

## SMTP configureren met environment variables

Acorn Mail verwacht de volgende omgeving-variabelen:

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

Zodra deze waarden gevuld zijn, detecteert Acorn Mail dat er credentials beschikbaar zijn en configureert het SMTP automatisch via PHPMailer. Dat maakt het gedrag ook lekker voorspelbaar: leeg is ‘geen SMTP’, gevuld is ‘SMTP actief’.

### Geavanceerde configuratie: `mail.php` publiceren

Heb je meer controle nodig dan alleen de basisvariabelen, dan kun je volgens de aankondiging een configuratiebestand publiceren. Dat doe je via de Acorn CLI:

```
wp acorn mail:config
```

Daarmee krijg je een `mail.php` configbestand dat je kunt gebruiken voor geavanceerdere instellingen (de exacte opties hangen af van de config die het package publiceert).

## SMTP testen zonder giswerk: `wp acorn mail:test`

Het grootste praktische voordeel zit ’m voor veel developers in het testen. In plaats van een ‘Test mail versturen’-knop met minimale feedback, biedt Acorn Mail een CLI-commando:

```
wp acorn mail:test [--to=]
```

Met dit commando verstuur je een testmail naar een opgegeven adres. Belangrijker: het commando is bedoeld om fouten onderweg netjes te tonen, zodat je snel ziet of het probleem zit in DNS/poort, credentials, relay policies of iets anders in de keten.

#### Let op met debug-output in CI

Als je mailtests in pipelines draait, denk dan na over waar output terechtkomt. SMTP-issues kunnen per ongeluk gevoelige hints geven. Houd logs schoon en beperk wie ze kan inzien.

## Waarom Roots dit oplost op package-niveau (en niet als klassieke plugin)

De onderliggende gedachte is herkenbaar als je met Roots/Sage/Acorn werkt: liever configuratie als code, en tooling die past bij een moderne workflow. SMTP is bij uitstek zo’n onderwerp waar je niet wilt leunen op een UI-instelling die iemand ooit in wp-admin aanklikte, en waar je wél behoefte hebt aan reproduceerbare setup per omgeving.

Door direct te koppelen aan PHPMailer — de plek waar WordPress uiteindelijk toch uitkomt — blijft het model simpel: WordPress blijft WordPress, maar je SMTP-configuratie wordt consistenter en beter testbaar.

## Samenvatting

1. SMTP in WordPress is vaak fragiel over omgevingen heen, en debugging is meestal matig.
2. Acorn Mail brengt SMTP-configuratie terug naar environment variables en haakt automatisch in op WordPress’ PHPMailer.
3. Installatie gaat via Composer: `composer require roots/acorn-mail`.
4. Je zet `MAIL_HOST`, `MAIL_PORT`, `MAIL_USERNAME`, `MAIL_PASSWORD`, `MAIL_FROM_ADDRESS`, `MAIL_FROM_NAME` en Acorn Mail regelt de rest.
5. Testen kan via CLI met `wp acorn mail:test [--to=]`, met de bedoeling om fouten duidelijk weer te geven.

## Referenties / Bronnen

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