Отправка почты в Craft CMS через SMTP

Craft отправляет активацию аккаунтов, восстановление пароля и всё, что отправляют ваши шаблоны и плагины, через один почтовый компонент, а он по умолчанию использует sendmail сервера. SMTP встроен — плагин не нужен, а переключение на fmailer занимает один экран настроек.

Параметры подключения

Данные подключения в .env

Настройки почты хранятся в project config, который обычно лежит в репозитории. Значения держите в .env, а в панели ссылайтесь на них:

SYSTEM_EMAIL=noreply@mail.example.ru
SMTP_HOST=smtp.fmailer.ru
SMTP_PORT=587
SMTP_USERNAME=<логин токена>
SMTP_PASSWORD=<пароль токена>

Раздел Settings → Email

В панели управления откройте Settings → Email и заполните поля:

Или в config/app.php

Чтобы вообще убрать почту из панели управления или задать разный транспорт для разных окружений, переопределите компонент mailer:

<?php
// config/app.php — перекрывает настройки SMTP из панели управления
use craft\helpers\App;
use craft\helpers\MailerHelper;
use craft\mail\transportadapters\Smtp;

return [
    'components' => [
        'mailer' => function() {
            $config = App::mailerConfig();

            $adapter = MailerHelper::createTransportAdapter(Smtp::class, [
                'host' => App::env('SMTP_HOST'),
                'port' => App::env('SMTP_PORT'),
                'useAuthentication' => true,
                'username' => App::env('SMTP_USERNAME'),
                'password' => App::env('SMTP_PASSWORD'),
            ]);
            $config['transport'] = $adapter->defineTransport();

            return Craft::createObject($config);
        },
    ],
];

Проверка

Нажмите Test внизу страницы Settings → Email или выполните ту же проверку из консоли — она выводит ошибку SMTP целиком:

php craft mailer/test --to=you@example.ru

На тестовом стенде общая настройка testToEmailAddress отправляет все письма на один адрес, чтобы не писать реальным пользователям.

Разбор ошибок