Эмуляция почтового сервера

При развёртывании Django к проекту был автоматически подключён модуль django.contib.auth. В числе прочего он содержит сценарий восстановления пароля: пользователь отправляет через специальную веб-форму свой email, и если этот адрес есть в базе, ему уходит письмо с инструкцией по восстановлению.

Но мы-то знаем, что никакое письмо никуда не уходит.

Для отправки писем в распоряжении разработчика должен быть настроенный почтовый сервер и зарегистрированный на нём аккаунт, от имени которого будет уходить письмо. Сейчас у нас всего этого нет, и при попытке восстановить пароль текст письма просто появится в консоли, но никуда не отправится и нигде не сохранится.

Можно создать свой почтовый сервер или работать с крупными почтовыми сервисами, но они могут быть недоступны, если вы работаете в корпоративной сети или, например, оказались оффлайн на одном из островов Индонезии.

Для обхода этой проблемы в Django можно настроить эмуляцию работы почтового сервера. Система будет производить все действия по отправке писем, но в реальности они никуда отправляться не будут. При тестировании проекта это удобно: почтовый ящик не будет завален тестовыми письмами, да и отлаживать отправку почты можно оффлайн.

Сохранение писем в файлы

В Django есть несколько модулей для отправки писем, подключить их можно через ключ конфигурации EMAIL_BACKEND в settings.py:

Скопировать кодPYTHON
EMAIL_BACKEND = 'django.core.mail.backends.XXX'

Вместо XXX указывается название модуля.

Встроенные в Django почтовые модули могут отправлять почту по протоколу SMTP, выводить в консоль содержимое письма, сохранять письма в файлы, хранить их в памяти или просто ничего не делать (даже для «ничего не делать» написан специальный модуль).

Мы подключим модуль filebased.EmailBackend: он будет сохранять текст отправленных электронных писем в файлы в отдельную директорию. Добавьте в settings.py следующий код:

Скопировать кодPYTHON
#  подключаем движок filebased.EmailBackend
EMAIL_BACKEND = "django.core.mail.backends.filebased.EmailBackend"
# указываем директорию, в которую будут складываться файлы писем
EMAIL_FILE_PATH = os.path.join(BASE_DIR, "sent_emails")

Создайте папку /sent_emails в головной директории проекта.

Теперь при запросе на восстановление пароля система будет делать вид, что отправила письмо, но эти письма будут «отправляться» в директорию sent_emails.

Пройдите процедуру восстановления пароля для своего пользователя. Если вы всё настроили правильно — в sent_emails будут созданы файлы с текстом уведомления.

Делать не нужно, но знать полезно

Для работы с почтой в Django есть специальный модуль Mail, отправкой писем занимаются функции из этого модуля:

send_mail() — для отправки единичного письма получателю.
send_mass_mail() — для отправки множества писем.
mail_admins — отправить письмо администраторам сайта. Список адресов администраторов перечисляется в списке ADMINS в settings.py.
mail_managers — для отправки писем менеджерам сайта. Большой проект может управляться большим количеством сотрудников, и в списке MANAGERS конфига можно задать список их почтовых адресов, по которым будет идти служебная рассылка.

Отдельная функция для массовой отправки писем потребовалась потому, что каждое подключение к почтовому серверу технически обходится дорого. Надо дождаться соединения, отправить авторизационную информацию, затем отправить сообщения — при массовой рассылке эти операции необходимо оптимизировать отдельно.

Самый простой способ отправить письмо из собственной view-функции или класса — вызвать стандартную функцию Django send_mail() и передать ей на вход необходимые данные:

Скопировать кодPYTHON
from django.core.mail import send_mail

send_mail(
    'Тема письма',
    'Текст письма.',
    'from@example.com',  # Это поле "От кого"
    ['to@example.com'],  # Это поле "Кому" (можно указать список адресов)
    fail_silently=False, # Сообщать об ошибках («молчать ли об ошибках?»)
)

Пока что нет необходимости делать это в проекте, но кто знает, что будет завтра.