Как настроить SMTP в Laravel

Что указать в Laravel

Настройка по шагам

1. Купите SMTP-пакет на странице Bulko SMTP Relay и скопируйте логин и пароль в разделе Dashboard -> SMTP Access (их также присылают на почту сразу после оплаты).
2. Откройте файл .env в корне проекта и задайте MAIL_MAILER=smtp, MAIL_HOST=smtp.bulko.io и MAIL_PORT=587.
3. Заполните MAIL_USERNAME и MAIL_PASSWORD. Если в пароле есть #, пробелы или $, возьмите его в одинарные кавычки: без кавычек значение обрезается на #, а в двойных кавычках подставляются переменные ${...}.
4. Для портов 587 и 2525 оставьте MAIL_SCHEME=null. Symfony Mailer, на котором построена почта в Laravel, подключится по обычному SMTP и сам переключится на TLS через STARTTLS. Только для порта 465 укажите MAIL_SCHEME=smtps (при пустой схеме и порте 465 Laravel выберет smtps сам).
5. В MAIL_FROM_ADDRESS укажите адрес на своём домене. Чтобы SPF, DKIM и DMARC были выровнены, подтвердите домен в разделе Sending Domains личного кабинета Bulko (DKIM с селектором bk1 и CNAME bnc.yourdomain.com).
6. Загляните в config/mail.php: в Laravel 11, 12 и 13 мейлер smtp по умолчанию уже читает MAIL_SCHEME, MAIL_HOST, MAIL_PORT, MAIL_USERNAME и MAIL_PASSWORD, так что обычно править ничего не нужно.
7. Выполните php artisan config:clear, чтобы закешированный конфиг не перекрывал новые значения, и перезапустите воркеры очередей (php artisan queue:restart), если письма уходят из очереди.

MAIL_SCHEME или MAIL_ENCRYPTION

В проектах, созданных до обновления скелета Laravel 11, часто остаются MAIL_ENCRYPTION=tls и ключ encryption в config/mail.php. Актуальные версии Laravel собирают транспорт только по scheme и port, поэтому MAIL_ENCRYPTION там ни на что не влияет. Допустимые значения MAIL_SCHEME: только smtp и smtps. Значения вроде tls или ssl приводят к ошибке о неподдерживаемой схеме. Чем отличаются порты 587, 465 и 2525, описано в статье о SMTP-портах.

.env и config/mail.php

# .env (Laravel 11, 12 and 13)
MAIL_MAILER=smtp
MAIL_SCHEME=null
MAIL_HOST=smtp.bulko.io
MAIL_PORT=587
MAIL_USERNAME=smtp_xxxxxxxxxxxxxxxx
MAIL_PASSWORD='your-smtp-password'
MAIL_FROM_ADDRESS="[email protected]"
MAIL_FROM_NAME="${APP_NAME}"

# Порт 465 (неявный TLS) вместо 587:
# MAIL_PORT=465
# MAIL_SCHEME=smtps

# Хостинг блокирует 587 и 465? Используйте 2525 (STARTTLS):
# MAIL_PORT=2525

# config/mail.php (стандартный файл, менять не нужно):
# 'smtp' => [
#     'transport' => 'smtp',
#     'scheme' => env('MAIL_SCHEME'),
#     'url' => env('MAIL_URL'),
#     'host' => env('MAIL_HOST', '127.0.0.1'),
#     'port' => env('MAIL_PORT', 2525),
#     'username' => env('MAIL_USERNAME'),
#     'password' => env('MAIL_PASSWORD'),
#     'timeout' => null,
#     'local_domain' => env('MAIL_EHLO_DOMAIN', parse_url((string) env('APP_URL', 'http://localhost'), PHP_URL_HOST)),
# ],

# Проверка из терминала:
# php artisan config:clear
# php artisan tinker
# > Mail::raw('Bulko SMTP test from Laravel', fn ($m) => $m->to('[email protected]')->subject('Laravel SMTP test'));

Проверка

Запустите php artisan tinker и выполните Mail::raw('Bulko SMTP test from Laravel', fn ($m) => $m->to('[email protected]')->subject('Laravel SMTP test'));, подставив ящик, который можете проверить. Если tinker вернул объект SentMessage без исключения, релей принял письмо, и оно должно прийти в течение минуты-двух.

Если Laravel выбросил TransportException, в тексте ошибки будет код ответа SMTP (например, 535 или 554 5.7.1). По нему найдите нужную строку в таблице ниже. Если письмо отправляется из контроллера или задачи в очереди, смотрите также storage/logs/laravel.log.

Ошибки и решения

Частые вопросы

Какой порт выбрать в Laravel: 587 или 465?

Берите 587 с пустым MAIL_SCHEME, это STARTTLS. Порт 465 используйте только вместе с MAIL_SCHEME=smtps. Порт 2525 работает как 587 и выручает, когда хостинг закрывает стандартные порты.

Нужен ли MAIL_ENCRYPTION в Laravel 11 и 12?

Нет. Актуальный config/mail.php использует MAIL_SCHEME, а фреймворк при создании SMTP-транспорта MAIL_ENCRYPTION не читает. Эту строку можно удалить из .env.

Можно ли через этот релей получать входящую почту?

Нет. Bulko SMTP работает только на отправку, IMAP и почтового ящика нет. Ответы приходят на адрес From или Reply-To, который вы указали в Laravel.

Сколько писем в день может отправить приложение?

По умолчанию лимит 2 000 писем в сутки на один SMTP-аккаунт. Чтобы его поднять, напишите на [email protected].

Сколько это стоит?

Пакеты оплачиваются один раз: $5 за 5 000 писем, $15 за 20 000, $30 за 50 000 или $60 за 150 000. Неиспользованные письма не сгорают, бесплатного пробного периода для SMTP нет.

Работают ли очереди и уведомления?

Да. Mailable в очереди и почтовые уведомления используют тот же мейлер smtp, поэтому после настройки .env они тоже идут через релей. Не забудьте перезапустить воркеры.