Почта

Платформа отправляет письма для верификации email, сброса пароля и уведомлений.

Настройка через Админ-панель

Почта настраивается только через админ-панель, а не через .env. Переменные MAIL_* в .env не используются.

Admin Panel → Почта (/admin-panel/settings/mail)

Параметры хранятся в таблице config (ключ mail, JSON) и применяются через MailServiceProvider без перезапуска сервера:

Поле	Назначение
Mailer	Транспорт (smtp)
Host	Адрес SMTP-сервера
Port	Порт (465, 587, 25)
Username	Логин SMTP — также используется как адрес отправителя (mail.from.address)
Password	Пароль SMTP
Encryption	Шифрование: ssl, tls или без
From Name	Имя отправителя

Отдельного поля «From Address» нет: адрес отправителя берётся из Username.

После сохранения настройки вступают в силу немедленно — перезапуск контейнера не нужен.

Популярные SMTP-провайдеры

Укажите параметры в админ-панели (раздел Почта). В dev-окружении по умолчанию Mailhog не включён — docker-compose.yml не содержит SMTP-перехватчик.

Gmail

Host: smtp.gmail.com
Port: 587
Encryption: tls
Username: your@gmail.com

Для Gmail используйте App Password с двухфакторной аутентификацией.

Mailgun

Host: smtp.mailgun.org
Port: 587
Encryption: tls

Яндекс.Почта

Host: smtp.yandex.ru
Port: 465
Encryption: ssl
Username: your@yandex.ru

Sendgrid

Host: smtp.sendgrid.net
Port: 587
Encryption: tls
Username: apikey
Password: {ваш API-ключ}

Проверка отправки

После настройки SMTP отправьте тестовое письмо через Artisan:

docker compose exec app php artisan tinker

Mail::raw('Test', fn($m) => $m->to('test@example.com')->subject('Test'));

Отладка ошибок

При проблемах с доставкой:

1. Проверьте storage/logs/laravel.log на наличие ошибок SMTP
2. Убедитесь, что SMTP-сервер доступен из контейнера
3. Проверьте SPF/DKIM записи для вашего домена
4. Адрес отправителя (Username) должен совпадать с доменом SMTP-аккаунта

Email для системных уведомлений

Категории писем, которые отправляет платформа:

Событие	Получатель
Верификация email	Новый пользователь
Сброс пароля	Пользователь
Уведомления (реакции, ответы, упоминания)	Подписчики
Новостная рассылка	Подписчики рассылки

Пользователи управляют получением уведомлений через Настройки → Уведомления.