Как настроить отправку email в Django

Отправка email в Django

Django предоставляет удобный API для отправки электронных писем. Это мощный инструмент для автоматизации уведомлений, рассылок и коммуникации с пользователями.

Настройка SMTP

Базовая конфигурация SMTP в settings.py:

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.gmail.com'
EMAIL_PORT = 587
EMAIL_USE_TLS = True
EMAIL_HOST_USER = 'your-email@gmail.com'
EMAIL_HOST_PASSWORD = 'your-app-password'
DEFAULT_FROM_EMAIL = 'your-email@gmail.com'

Настройка для различных провайдеров

Gmail (с двухфакторной аутентификацией):

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.gmail.com'
EMAIL_PORT = 587
EMAIL_USE_TLS = True
EMAIL_HOST_USER = 'your-email@gmail.com'
EMAIL_HOST_PASSWORD = 'your-app-password'  # Пароль приложения, не обычный пароль

Yandex:

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.yandex.ru'
EMAIL_PORT = 465
EMAIL_USE_SSL = True
EMAIL_HOST_USER = 'your-email@yandex.ru'
EMAIL_HOST_PASSWORD = 'your-password'

Mail.ru:

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.mail.ru'
EMAIL_PORT = 465
EMAIL_USE_SSL = True
EMAIL_HOST_USER = 'your-email@mail.ru'
EMAIL_HOST_PASSWORD = 'your-password'

Отправка простых писем

Базовый пример отправки email:

from django.core.mail import send_mail
from django.conf import settings

def send_welcome_email(user_email, username):
    subject = 'Добро пожаловать на наш сайт!'
    message = f'Привет, {username}! Мы рады видеть тебя в нашей системе.'

    send_mail(
        subject=subject,
        message=message,
        from_email=settings.DEFAULT_FROM_EMAIL,
        recipient_list=[user_email],
        fail_silently=False,
    )

Отправка HTML писем

Создание красивых HTML писем:

from django.core.mail import send_mail
from django.template.loader import render_to_string
from django.utils.html import strip_tags

def send_html_email(user_email, username):
    subject = 'Добро пожаловать!'

    # HTML версия письма
    html_message = render_to_string('emails/welcome.html', {
        'username': username,
        'site_name': 'Мой сайт'
    })

    # Текстовая версия (для клиентов без поддержки HTML)
    plain_message = strip_tags(html_message)

    send_mail(
        subject=subject,
        message=plain_message,
        from_email=settings.DEFAULT_FROM_EMAIL,
        recipient_list=[user_email],
        html_message=html_message,
        fail_silently=False,
    )

HTML шаблон для письма

Создай файл templates/emails/welcome.html:

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>Добро пожаловать</title>
</head>
<body style="font-family: Arial, sans-serif; line-height: 1.6; color: #333;">
    <div style="max-width: 600px; margin: 0 auto; padding: 20px;">
        <h1 style="color: #2c3e50;">Добро пожаловать, {{ username }}!</h1>
        <p>Мы рады видеть тебя на сайте <strong>{{ site_name }}</strong>.</p>
        <p>Твой аккаунт успешно создан и готов к использованию.</p>
        <div style="background-color: #f8f9fa; padding: 15px; border-radius: 5px; margin: 20px 0;">
            <p style="margin: 0;"><strong>Что дальше?</strong></p>
            <ul style="margin: 10px 0;">
                <li>Заполни свой профиль</li>
                <li>Изучи доступные курсы</li>
                <li>Присоединяйся к сообществу</li>
            </ul>
        </div>
        <p>Если у тебя есть вопросы, не стесняйся обращаться в поддержку.</p>
        <p>С уважением,<br>Команда {{ site_name }}</p>
    </div>
</body>
</html>

Отправка писем с вложениями

Использование EmailMessage для отправки файлов:

from django.core.mail import EmailMessage
from django.conf import settings
import os

def send_email_with_attachment(user_email, username, file_path):
    subject = 'Документ для тебя'

    html_message = render_to_string('emails/document.html', {
        'username': username
    })

    email = EmailMessage(
        subject=subject,
        body=html_message,
        from_email=settings.DEFAULT_FROM_EMAIL,
        to=[user_email]
    )
    email.content_subtype = "html"

    # Добавляем вложение
    if os.path.exists(file_path):
        with open(file_path, 'rb') as f:
            email.attach(
                os.path.basename(file_path),
                f.read(),
                'application/pdf'
            )

    email.send()

Массовая рассылка

Отправка писем множеству получателей:

from django.core.mail import send_mass_mail
from django.contrib.auth.models import User

def send_newsletter_to_all_users():
    # Получаем всех активных пользователей
    users = User.objects.filter(is_active=True)

    # Создаем список кортежей для массовой отправки
    email_tuples = []
    for user in users:
        email_tuple = (
            'Новости сайта',  # subject
            f'Привет, {user.username}! У нас есть новости для тебя.',  # message
            settings.DEFAULT_FROM_EMAIL,  # from_email
            [user.email],  # recipient_list
        )
        email_tuples.append(email_tuple)

    # Отправляем все письма одним вызовом
    send_mass_mail(email_tuples, fail_silently=False)

Асинхронная отправка email

Использование Celery для фоновой отправки:

from celery import shared_task
from django.core.mail import send_mail
from django.conf import settings

@shared_task
def send_email_task(subject, message, recipient_list, html_message=None):
    try:
        send_mail(
            subject=subject,
            message=message,
            from_email=settings.DEFAULT_FROM_EMAIL,
            recipient_list=recipient_list,
            html_message=html_message,
            fail_silently=False,
        )
        return f'Email успешно отправлен на {recipient_list}'
    except Exception as e:
        return f'Ошибка отправки email: {str(e)}'

# Использование в коде
def send_welcome_email_async(user_email, username):
    subject = 'Добро пожаловать!'
    message = f'Привет, {username}!'

    # Запускаем задачу в фоне
    send_email_task.delay(subject, message, [user_email])

Настройка для разработки

Использование консольного бэкенда для тестирования:

# settings.py для разработки
if DEBUG:
    EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'
else:
    EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
    EMAIL_HOST = 'smtp.gmail.com'
    EMAIL_PORT = 587
    EMAIL_USE_TLS = True
    EMAIL_HOST_USER = 'your-email@gmail.com'
    EMAIL_HOST_PASSWORD = 'your-app-password'

Обработка ошибок

Надежная отправка с обработкой исключений:

import logging
from django.core.mail import send_mail
from smtplib import SMTPException

logger = logging.getLogger(__name__)

def send_email_safely(subject, message, recipient_list):
    try:
        result = send_mail(
            subject=subject,
            message=message,
            from_email=settings.DEFAULT_FROM_EMAIL,
            recipient_list=recipient_list,
            fail_silently=False,
        )

        if result == 1:
            logger.info(f'Email успешно отправлен на {recipient_list}')
            return True
        else:
            logger.error(f'Ошибка отправки email на {recipient_list}')
            return False

    except SMTPException as e:
        logger.error(f'SMTP ошибка при отправке email: {e}')
        return False
    except Exception as e:
        logger.error(f'Неожиданная ошибка при отправке email: {e}')
        return False

Лучшие практики

Используй переменные окружения - не храни пароли в коде
Создавай HTML шаблоны - для красивого оформления писем
Добавляй текстовую версию - для клиентов без поддержки HTML
Обрабатывай ошибки - логируй проблемы с отправкой
Используй очереди - Celery для асинхронной отправки
Тестируй на staging - перед отправкой в production
Соблюдай лимиты - не превышай квоты провайдера
Валидируй email адреса - проверяй корректность перед отправкой

Тестирование email

Создание тестов для проверки отправки:

from django.test import TestCase
from django.core import mail
from django.contrib.auth.models import User

class EmailTestCase(TestCase):
    def test_welcome_email_sending(self):
        # Очищаем outbox перед тестом
        mail.outbox.clear()

        # Отправляем email
        send_welcome_email('test@example.com', 'testuser')

        # Проверяем, что email был отправлен
        self.assertEqual(len(mail.outbox), 1)
        self.assertEqual(mail.outbox[0].to, ['test@example.com'])
        self.assertEqual(mail.outbox[0].subject, 'Добро пожаловать на наш сайт!')

    def test_html_email_content(self):
        mail.outbox.clear()

        send_html_email('test@example.com', 'testuser')

        email = mail.outbox[0]
        self.assertIn('html_message', email.__dict__)
        self.assertIn('testuser', email.body)

FAQ

Q: Как отправить HTML письмо?
A: Используй параметр html_message в send_mail или создай HTML шаблон с помощью render_to_string.

Q: Почему письма не отправляются с Gmail?
A: Включи двухфакторную аутентификацию и создай пароль приложения в настройках Google аккаунта.

Q: Как отправить письмо с вложением?
A: Используй класс EmailMessage и метод attach() для добавления файлов.

Q: Можно ли отправить письмо нескольким получателям?
A: Да, передай список email адресов в recipient_list или используй send_mass_mail для массовой рассылки.

Q: Как настроить email для разработки?
A: Используй EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend' - письма будут выводиться в консоль.

Q: Как обрабатывать ошибки отправки?
A: Используй try-except блоки, логируй ошибки и настрой fail_silently=False для получения исключений.