Django邮件发送模块全解析：从单发到群发及多媒体处理

Django邮件发送模块概述

Python标准库中已内置smtp邮件发送模块，Django在此基础上进行了封装，使得在Django项目环境中能够更便捷、灵活地实现邮件发送功能。

所有相关功能均封装在django.core.mail模块中。

快速上手与基础配置

一、快速上手

仅需两行代码即可完成一封邮件的发送：

from django.core.mail import send_mail

send_mail(
  'Subject here',
  'Here is the message.',
  'from@example.com',
  ['to@example.com'],
  fail_silently=False,
)

导入所需功能模块后直接调用发送邮件接口，操作十分简便。

默认情况下，系统读取配置文件中的EMAIL_HOST和EMAIL_PORT以指定SMTP服务器主机及端口；EMAIL_HOST_USER和EMAIL_HOST_PASSWORD分别对应登录用户名和密码。若配置了EMAIL_USE_TLS或EMAIL_USE_SSL，则控制是否启用相应的加密连接协议。

单发功能send_mail详解

二、单发 send_mail()

方法原型：send_mail(subject, message, from_email, recipient_list, fail_silently=False, auth_user=None, auth_password=None, connection=None, html_message=None)[source]

接下来解析send_mail()方法，该方法接收多个参数，其中subject、message、from_email和recipient_list为必填项，其余为可选参数。

• subject：邮件主题，类型为字符串。
• message：邮件正文内容，类型为字符串。
• from_email：发件人邮箱地址，类型为字符串。
• recipient_list：收件人列表，由邮箱地址字符串组成的列表。注意，recipient_list中的每个成员都能在邮件的“To:”字段中看到其他所有收件人的地址。
• fail_silently：布尔值。若设为False，当send_mail发送失败时，将抛出smtplib.SMTPException异常；若为True，则静默忽略错误。
• auth_user：可选参数，用于指定验证SMTP服务器的用户名。若需特别指定某个邮箱账号进行发送，应设置此参数。若未提供，Django将自动使用settings配置中的EMAIL_HOST_USER值。若两者均未提供，则无法完成发送。
• auth_password：可选参数，用于指定验证SMTP服务器的密码。若未提供，Django将自动使用settings配置中的EMAIL_HOST_PASSWORD值。该参数与auth_user配合使用。
• connection：可选参数，指定用于发送邮件的电子邮件后端连接对象。
• html_message：若提供此参数，则允许发送包含HTML代码的邮件。
• send_mail()方法的返回值为成功发送的邮件数量，由于该方法仅支持单次发送，返回值只能是0或1。

群发功能send_mass_mail详解

三、群发 send_mass_mail()

方法原型：send_mass_mail(datatuple, fail_silently=False, auth_user=None, auth_password=None, connection=None)[source]

send_mass_mail()方法专门用于处理大批量邮件任务，即所谓的群发场景。

其参数中，datatuple为必需参数，接收一个元组，元组内每个元素的格式如下：

(subject, message, from_email, recipient_list)

上述四个字段的含义与send_mail()方法中的对应参数一致。

例如，以下代码示例将向两组不同的收件人发送两条不同的消息，但整个过程仅建立一次到邮件服务器的连接：

message1 = ('Subject here', 'Here is the message', 'from@example.com', ['first@example.com', 'other@example.com'])

message2 = ('Another Subject', 'Here is another message', 'from@example.com', ['second@test.com'])

send_mass_mail((message1, message2), fail_silently=False)

send_mass_mail()方法的返回值为成功发送的邮件总数量。

对比send_mail()方法，每次调用send_mail()都会与SMTP服务器建立一次新连接（即发一次连一次），效率较低。而send_mass_mail()仅建立一次连接即可发送所有邮件，因此效率更高。

安全防护：防止头部注入

四、防止头部注入攻击

当根据用户表单输入动态构造电子邮件时，存在头部注入攻击的风险。Django提供了一定的防范机制，但在更多情况下，仍需开发者自行编写安全校验代码。

以下示例演示如何接收用户输入的主题、邮件内容及发送方，并将邮件发送至系统管理员：

from django.core.mail import send_mail, BadHeaderError
from django.http import HttpResponse, HttpResponseRedirect

def send_email(request):
  subject = request.POST.get('subject', '')
  message = request.POST.get('message', '')
  from_email = request.POST.get('from_email', '')
  if subject and message and from_email:
    try:
      send_mail(subject, message, from_email, ['admin@example.com'])
    except BadHeaderError:
      return HttpResponse('Invalid header found.')
    return HttpResponseRedirect('/contact/thanks/')
  else:
    # In reality we'd use a form class
    # to get proper validation errors.
    return HttpResponse('Make sure all fields are entered and valid.')

若检测到用户输入包含头部注入攻击的特征，系统将抛出BadHeaderError异常。

多媒体邮件发送技巧

五、发送多媒体邮件

默认情况下，发送的邮件均为纯文本格式。但有时我们需要在邮件中包含超级链接、图片，甚至视频和JavaScript交互动作。

Django提供了EmailMultiAlternatives类，支持同时发送文本和HTML内容。以下是具体范例，开发者可直接参考编写：

from django.core.mail import EmailMultiAlternatives

subject, from_email, to = 'hello', 'from@example.com', 'to@example.com'
text_content = 'This is an important message.'
html_content = '<p>This is an <strong>important</strong> message.</p>'
msg = EmailMultiAlternatives(subject, text_content, from_email, [to])
msg.attach_alternative(html_content, "text/html")
msg.send()

需要提醒的是，接收方的邮件服务商未必支持多媒体邮件，这可能是出于安全考虑或其他原因。为确保邮件内容能被正常阅读，务必同时发送纯文本版本作为备用。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持本站。