---
title: "Acorn Mail: pagaliau tvarkingas SMTP konfigūravimas ir testavimas WordPress’e per CLI"
url: "https://helloblog.io/lt/acorn-mail-smtp-konfiguravimas-ir-testavimas-wordpress-per-cli/"
date: "2024-03-19"
modified: "2026-01-20"
author: "Mantas Jonaitis"
language: "lt_LT"
categories: ["WordPress"]
tags: ["Acorn", "PHPMailer", "SMTP", "WordPress", "WP-CLI"]
featured_image: "https://helloblog.io/app/uploads/sites/20/2026/01/featured-6-1024x572.jpg"
excerpt: "SMTP WordPress’e dažnai sugenda ten, kur mažiausiai tikiesi: skirtingos aplinkos, tylūs klaidų pranešimai ir įtartini pluginai. Acorn Mail siūlo paprastesnį kelią: konfigūracija per env ir aiškus testavimas per WP-CLI."
---

# Acorn Mail: pagaliau tvarkingas SMTP konfigūravimas ir testavimas WordPress’e per CLI

Jei esi kada nors bandęs suvienodinti WordPress el. pašto siuntimą per SMTP keliose aplinkose (lokaliai, staging, production), turbūt žinai klasiką: vienur veikia, kitur ne; pluginas rodo „success“, o realiai laiškai neateina; o klaidų diagnostika dažnai baigiasi spėlionėmis. Prie viso to prisideda ir saugumo rizikos — SMTP pluginai istorijoje jau yra turėję pažeidžiamumų.

Roots komanda šitą problemą sprendžia praktiškai ir kūrėjams patogiai: pristatė [Acorn Mail](https://github.com/roots/acorn-mail) — paketą, kuris automatizuoja SMTP prijungimą prie WordPress `PHPMailer` ir prideda aiškų testavimo komandų rinkinį per Acorn CLI (tai yra WP-CLI komandos, kurias teikia Roots Acorn).

## Kas yra Acorn Mail ir kuo jis skiriasi nuo SMTP pluginų?

Acorn Mail yra Composer diegiamas paketas, skirtas projektams, kurie naudoja Roots Acorn. Vietoj dar vieno WordPress admin’e konfigūruojamo plugin’o, čia akcentas dedamas į du dalykus: (1) konfigūraciją per aplinkos kintamuosius (`env`), kad ji būtų nuspėjama ir valdoma per infrastruktūrą, ir (2) realų testavimą per CLI su aiškiai atvaizduojamomis klaidomis.

Techniškai Acorn Mail prisikabina prie WordPress `PHPMailer` instancijos ir, kai aptinka ne tuščius prisijungimo parametrus, sukonfigūruoja SMTP automatiškai. Tai reiškia, kad tavo aplikacija siunčia laiškus per SMTP be atskiro plugin’o „magijos“ ir be papildomų UI sluoksnių.

#### Trumpai apie terminus

`PHPMailer` yra biblioteka, kurią WordPress naudoja el. pašto siuntimui. SMTP yra protokolas (ir dažnai el. pašto tiekėjų reikalaujamas kelias), leidžiantis patikimiau išsiųsti laiškus nei „default“ serverio `mail()`.

## Diegimas: Composer ir minimalus env rinkinys

Acorn Mail diegiamas šalia Acorn kaip įprastas Composer dependency. Tai ypač patogu komandose, kur WordPress projektas jau valdomas kaip moderni PHP aplikacija (su Composer, env konfigūracija, CI/CD).

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

Po diegimo užtenka suvesti SMTP prisijungimo duomenis per aplinkos kintamuosius. Kai jie aptinkami (ne tušti), Acorn Mail automatiškai sukonfigūruoja WordPress pašto siuntimą per SMTP.

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

## Pažangesnė konfigūracija: `mail.php` publikavimas

Jei reikia daugiau kontrolės nei vien tik baziniai `MAIL_*` kintamieji (pvz., projekto lygio nustatymai, papildomos parinktys ar tiesiog norisi turėti aiškų konfigūracijos failą repozitorijoje), Acorn Mail leidžia „publishinti“ konfigūraciją į `mail.php`.

```
wp acorn mail:config
```

#### Saugumo praktika

SMTP slaptažodžių nelaikyk repozitorijoje. Net jei publikuoji `mail.php`, jautri informacija vis tiek turėtų ateiti iš `env`/secrets valdymo (CI/CD, hosting provider secrets, Vault ir pan.).

## Testavimas, kuris pagaliau pasako, kas blogai

Didžiausia praktinė nauda, mano akimis, yra testavimo komanda. Vietoj „Send test email“ mygtuko, kuris dažnai neduoda jokios diagnostikos, čia turi CLI komandą, kuri bando išsiųsti laišką ir švariai parodo klaidas pakeliui (pvz., neteisingas host’as, port’as, auth, TLS niuansai ar tinklo blokavimai).

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

Komanda leidžia nurodyti gavėją per `--to=` parametrą. Tai patogu tiek lokaliai, tiek CI aplinkoje, tiek debugging’ui produkcijoje, kai reikia greitai patikrinti, ar nauji SMTP kredencialai tikrai veikia.

## Kada Acorn Mail labiausiai „sueina“

- Kai WordPress projektas valdomas kaip aplikacija: Composer, env kintamieji, diegimai per pipeline’ą.
- Kai turi kelias aplinkas ir nori vienodos SMTP konfigūracijos be rankinio admin’o klikčiojimo.
- Kai reikia greitai ir aiškiai patikrinti SMTP po konfigūracijų pakeitimų (host/port/credentials).
- Kai nori mažiau priklausomybės nuo SMTP pluginų ir jų saugumo/atnaujinimų ciklo.

## Santrauka

Acorn Mail bando išspręsti labai realų WordPress skausmą: patikimą SMTP sukonfigūravimą ir normalią diagnostiką. Diegimas vyksta per Composer, konfigūracija — per `MAIL_*` env kintamuosius, o svarbiausia dalis kasdienybėje — `wp acorn mail:test`, kuri leidžia greitai patikrinti siuntimą ir pamatyti klaidas ne spėliojant, o faktais.

## Nuorodos / Šaltiniai

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