Yii + Mailexam

Минимальный пример Yii 2, который отправляет тестовое письмо через SMTP Mailexam с помощью yii2-symfonymailer.

Основан на руководстве Mailexam для Yii.

Что понадобится

• Аккаунт Mailexam и проект с SMTP-учётными данными.
• PHP 8.2+ и Composer.

Из приветственного письма или личного кабинета Mailexam:

Быстрый старт (на хосте)

1. Установите зависимости:

composer install

2. Скопируйте пример файла окружения и заполните учётные данные:

cp .env.example .env

3. Отредактируйте .env:

MAILEXAM_LOGIN=ВАШ_ЛОГИН
MAILEXAM_PASSWORD=ВАШ_ПАРОЛЬ
MAILEXAM_PORT=587
MAIL_FROM=noreply@example.test

4. Запустите встроенный PHP-сервер:

php -S 127.0.0.1:8080 -t web

5. Отправьте тестовое письмо:

curl -X POST 'http://127.0.0.1:8080/index.php?r=mail/test' \
  -H 'Content-Type: application/json' \
  -d '{"to":"user@example.test","subject":"Тест","body":"Привет"}'

Письмо появится в личном кабинете Mailexam → ваш проект → входящие.

При Apache (Docker ниже) тот же маршрут доступен как POST /mail/test.

Переменные окружения

Структура проекта

.
├── composer.json
├── config/web.php              # компонент mailer (SMTP Mailexam)
├── controllers/MailController.php
├── web/index.php               # загружает .env через phpdotenv
├── .env.example
├── Dockerfile                  # только для локальной отладки
└── docker-compose.yml

Docker (отладка)

Docker предназначен для локальной отладки. Для повседневной разработки запускайте приложение на хосте (см. выше).

cp .env.example .env
# отредактируйте .env с учётными данными

docker compose up --build

Затем вызовите pretty URL на проброшенном порту:

curl -X POST http://127.0.0.1:8080/mail/test \
  -H 'Content-Type: application/json' \
  -d '{"to":"user@example.test","subject":"Тест","body":"Привет"}'

CI

Задайте эти секреты в окружении CI:

variables:
  MAILEXAM_LOGIN: $MAILEXAM_LOGIN
  MAILEXAM_PASSWORD: $MAILEXAM_PASSWORD
  MAILEXAM_PORT: "587"
  MAIL_FROM: "noreply@example.test"

После отправки письма в тесте проверьте доставку через API Mailexam.

Типичные проблемы

Письмо не отправлено, файлы в runtime/mail

• Проверьте useFileTransport => false в конфигурации mailer.

Ошибка TLS или подключения

• Хост должен быть {логин}.mailexam.ru, где {логин} совпадает с MAILEXAM_LOGIN.
• Логин и пароль должны быть из одного проекта Mailexam.

Переменные окружения пустые

• Убедитесь, что .env существует и Dotenv::createImmutable(...)->safeLoad() выполняется в web/index.php.

Письмо не в кабинете

• Откройте входящие того же проекта Mailexam.
• Проверьте runtime/logs/app.log на ошибки SMTP.

См. также

• Руководство Mailexam для Yii (wiki)
• Пример на Laravel — другой PHP-фреймворк
• Пример на ThinkPHP — другой PHP-фреймворк
• Отправка почты в Yii 2
• Документация API Mailexam

Лицензия

Apache 2.0