---
title: "Acorn Mail: kulturált SMTP beállítás és tesztelés WordPress-ben, Acorn CLI-vel"
url: "https://helloblog.io/hu/acorn-mail-smtp-beallitas-teszteles-wordpress-acorn-cli/"
date: "2024-03-19"
modified: "2026-01-20"
author: "Nagy Eszter"
language: "hu_HU"
categories: ["WordPress ökoszisztéma"]
tags: ["Acorn", "Composer", "SMTP", "WordPress", "WP-CLI"]
featured_image: "https://helloblog.io/app/uploads/sites/2/2026/01/featured-7-1024x572.jpg"
excerpt: "Az SMTP-s levélküldés WordPress-ben sokszor környezetfüggő, nehezen hibakereshető és bővítményektől kiszolgáltatott. Az Acorn Mail egy letisztult megoldás, ami környezeti változókból konfigurál, és parancssorból azonnal tesztelhetővé teszi a mail küldést."
---

# Acorn Mail: kulturált SMTP beállítás és tesztelés WordPress-ben, Acorn CLI-vel

WordPress-es projektnél az e-mail küldés tipikusan akkor kezd fájni, amikor végre élesben is megbízhatóan kell mennie: más a helyi gép, más a staging, más a production; közben a tárhelyszolgáltató korlátoz, a hitelesítés kényes, a hibaüzenetek pedig sokszor semmitmondóak. Sokan erre SMTP bővítményekkel próbálnak gyógyírt találni, de ezeknél gyakori a bizonytalan működés, a biztonsági kompromisszum, sőt időnként konkrét sérülékenységek is előfordulnak (a Roots posztja is hivatkozik egy ilyen esetre).

A Roots erre a problémacsomagra hozta ki az **Acorn Mail** csomagot: a célja, hogy WordPress-ben az SMTP konfigurálása és tesztelése ne plugin-kattintgatás legyen, hanem egy **környezeti változókkal** vezérelt, verziózható és **CLI-ből** (parancssorból) jól diagnosztizálható folyamat.

## Mi az Acorn Mail, és mikor éri meg használni?

Az **Acorn Mail** egy Composerrel telepíthető kiegészítő az **Acorn** (Roots) ökoszisztémához. Lényege, hogy ha megadod a levelezéshez szükséges SMTP adatokat **environment variable**-ökben (pl. `.env`), akkor a csomag automatikusan rácsatlakozik a WordPress által használt `PHPMailer` példányra, és beállítja az SMTP-t.

A gyakorlati haszon ott jön ki igazán, amikor:

- több környezeted van (local/staging/prod), és ugyanazt a konfigurációs mintát akarod mindenhol
- nem akarsz admin felületen tárolt SMTP jelszavakat és plugin-beállításokat menedzselni
- kell egy gyors, ismételhető levélküldés-teszt, ami ténylegesen visszaadja a hibát is, nem csak annyit, hogy „nem ment”

## Telepítés Composerrel

Az Acorn Mail az Acorn mellé telepíthető Composer csomagként. A Roots leírása szerint ennyi az egész:

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

## Alap SMTP konfiguráció környezeti változókkal

A beállítás központi ötlete, hogy a hitelesítő adatok ne a WordPress adminból jöjjenek, hanem környezeti változókból. Az Acorn Mail ezekre figyel:

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

A Roots posztja alapján a működés egyszerű: ha a fenti kredenciálok **nem üresek**, az Acorn Mail automatikusan „ráakaszkodik” a WordPress `PHPMailer` példányára, és beállítja az SMTP-t. Így nem kell külön plugin oldali hook-okat keresgélni vagy UI-ban kattintgatni; a konfiguráció egy helyen, a környezethez kötötten kezelhető.

#### Biztonsági alapelv

A `.env` fájlt ne kommitold verziókezelőbe, és production környezetben inkább a hosting/platform által biztosított environment variable kezelést használd. A lényeg: a jelszó ne kerüljön a repóba és ne legyen publikusan elérhető.

## Haladó beállítások: mail.php konfiguráció publikálása

Ha az alap környezeti változók nem elegendők, a Roots szerint lehetőség van egy `mail.php` konfigurációs fájl publikálására is az Acorn CLI segítségével:

```
wp acorn mail:config
```

Ez a lépés akkor jön jól, ha a projektben szeretnél egy dedikált konfigurációs fájlt a mail réteghez, és nem mindent csak environment változókon keresztül kezelnél.

## SMTP tesztelés értelmes hibajelentéssel (Acorn CLI)

Az egyik legidegesítőbb része az SMTP beüzemelésnek, hogy a „Send test email” gomb sok bővítményben vagy nem ad részletes hibát, vagy annyira elrejti a problémát, hogy marad a logvadászat. Az Acorn Mail ehhez ad egy célzott CLI parancsot, amivel test mailt tudsz küldeni:

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

A parancs lényege a bejelentés szerint, hogy tisztán, jól olvashatóan megjeleníti az út közben felmerülő hibákat, így gyorsabban kiderül, hogy DNS, port, auth, TLS vagy egyszerűen rossz „from” beállítás áll a háttérben.

## Miért jobb ez, mint egy átlagos SMTP bővítmény?

- **Kevesebb állapot az adminban:** a konfiguráció nem a WordPress adatbázisában, hanem környezetben él.
- **Jobb automatizálhatóság:** ugyanaz a beállítási minta CI/CD-ben és több környezetben is működik.
- **Gyorsabb hibakeresés:** a CLI teszt parancs célzottan a levélküldési útvonalat teszteli, és a Roots szerint közben a hibákat is jól láthatóvá teszi.
- **Kisebb plugin-kitettség:** a poszt külön kiemeli, hogy SMTP bővítményeknél előfordulhat instabil működés, biztonsági gond, sőt ismert sérülékenység is.

## Összefoglaló

Az Acorn Mail a Roots válasza arra a nagyon is ismerős problémára, hogy WordPress-ben az SMTP beállítás és a tesztelés sokszor körülményes és rosszul diagnosztizálható. Composeres telepítés, környezeti változó alapú konfiguráció, automatikus `PHPMailer` bekötés, és egy dedikált `wp acorn mail:test` parancs: ezek együtt egy jóval fejlesztőbarátabb mail réteget adnak az Acorn-alapú WordPress alkalmazásokhoz.

## Hivatkozások / Források

- [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)
