入门例子

只有两行:

from django.core.mail import send_mail

send_mail(u'邮件标题', u'邮件内容', '[email protected]',
    ['[email protected]'], fail_silently=False)

Django发邮件功能要用到配置文件中的 EMAIL_HOST 和 EMAIL_PORT 配置项，分别用来指定发邮件服务器和端口。 如果SMTP服务器需要用户认证，还须设置 EMAIL_HOST_USER 和 EMAIL_HOST_PASSWORD 配置项，指定用户名和密码。 而 EMAIL_USE_TLS 配置项则决定是否使用安全加密链接。

send_mail()

发邮件的最便捷方式就是使用 django.core.mail.send_mail() 。

subject, message, from_email and recipient_list 这四个参数是必须的。

• subject: 字符串，表示邮件标题。
• message: 字符串，表示邮件内容。
• from_email: 字符串，表示发件邮箱。
• recipient_list: 字符串列表，列表中每个成员都是一个邮箱地址，而且每个收件人都会在 “收件人/To:” 栏看到出现在 recipient_list 中的其他收件人。
• fail_silently: （可选）布尔值。为 False 时， send_mail 会抛出 smtplib.SMTPException 异常。smtplib 文档列出了所有可能的异常。 这些异常都是 SMTPException 的子类。
• auth_user: （可选）SMTP服务器的认证用户名。没提供该参数的情况下，Django会使用 EMAIL_HOST_USER 配置项的设置。
• auth_password: （可选）SMTP服务器的认证密码，没提供该参数的情况下，Django会使用EMAIL_HOST_PASSWORD 配置项的设置。
• connection: （可选）发送邮件的后端。没提供该参数的情况下，Django会使用默认后端的实例。可查看 Email backends 了解更多细节。

send_mass_mail()

django.core.mail.send_mass_mail() 适合处理群发邮件。

datatuple 是一个元组，其中每个元素格式如下:

(subject, message, from_email, recipient_list)

fail_silently, auth_user 和 auth_password 与上面 send_mail() 中提到的一样。

datatuple 中每个元素都对应一封单独的邮件。与上面 send_mail() 一样，出现在 recipient_list 中的收件人同样会在 “收件人/To:” 字段中看到该邮件的其他所有收件人。

举个例子，下面的代码会给双组不同的收件人发送两封不同的邮件；但仅仅打开一次邮件服务器的链接:

message1 = ('Subject here', 'Here is the message', '[email protected]', ['[email protected]', '[email protected]'])
message2 = ('Another Subject', 'Here is another message', '[email protected]', ['[email protected]'])
send_mass_mail((message1, message2), fail_silently=False)

mail_admins()

django.core.mail.mail_admins() 是一个给网站后台管理员(admin)发邮件的快捷方法，管理员设置放在 ADMINS配置项。

mail_admins() 使用 EMAIL_SUBJECT_PREFIX 配置项的值做为邮件标题的前缀，默认情况下是 "[Django] " 。

邮件的”From:”头的内容就是 SERVER_EMAIL 配置项的值。

该方法方便使用且易于理解。

如果提供了 html_message 参数，会导致邮件变成 multipart/alternative ， message 格式变成 text/plain ，html_message 格式变成 text/html 。

mail_managers()

django.core.mail.mail_managers() is just like mail_admins() ，不同之处在于该方法的邮件接收人是网站负责人(manager)， 可以在 MANAGERS 配置项设置网站负责人。

例子

该例同时给 [email protected] 和 [email protected] 发送同一封邮件，这两个邮箱地址都会出现在 “收件人/To:” 一栏:

send_mail('Subject', 'Message.', '[email protected]',
    ['[email protected]', '[email protected]'])

该例则是分别为 [email protected] 和 [email protected] 分别发送同一封邮件，每人收到的邮件只显示唯一一个收件人:

datatuple = (
    ('Subject', 'Message.', '[email protected]', ['[email protected]']),
    ('Subject', 'Message.', '[email protected]', ['[email protected]']),
)
send_mass_mail(datatuple)

防止邮件头注入

Header injection (邮件头信息注入)是可以被骇客（黑客hacker是指伟大的程序员，骇客Cracker和Attacker是指无知无耻的狗盗之辈）利用的安全漏洞。 他们会利用该漏洞，在代码生成的邮件报文中添加额外的邮件头信息(header)以控制 “收件人/To:” 和 “发件人/From:” 。

之前所提及的Django邮件函式都禁止在头信息中添加换行，从而避免注入。只要 subject , from_email 和recipient_list 包含换行（不管是Windows格式，还是Unix或是Mac OS 格式） ，发送函式 (比如 send_mail()) 都会抛出 django.core.mail.BadHeaderError 异常( ValueError 的一个子类)，也不会发送该邮件。 因此在给邮件函式传递参数之前，一定要对所有数据进行验证。

如果 message 在文本最开始处含有头信息，那么这些头信息就会被打印成邮件内容的第一个比特。

下面这个view例子， subject ， message 和 from_email 从request POST中取值，然后发送邮件到admin@example.com， 发送成功后重定向到”/contact/thanks/”:

from django.core.mail import send_mail, BadHeaderError

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, ['[email protected]'])
        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.')

EmailMessage类

Django的 send_mail() 和 send_mass_mail() 函式事实上是对 EmailMessage 类使用方式 的一个轻度封装。

send_mail() 和相关的其他封装函式并没有充分使用 EmailMessage 类的所有特性。 要想使用更多特性，比如暗送(BCC)给收件人，加入附件，或是多用途格式(multi-part)邮件，都要直接创建 EmailMessage 实例。

EmailMessage 仅仅负责创建邮件报文，而 email backend 则负责邮件发送。

为了方便起见， EmailMessage 提供了一个简单的 send() 方法用以发送纯文本邮件。如果想发送多用途格式邮件，可以使用后端API 发送多用途邮件.

email = EmailMessage('Hello', 'Body goes here', '[email protected]',
            ['[email protected]', '[email protected]'], ['[email protected]'],
            headers = {'Reply-To': '[email protected]'})

from django.core.mail import EmailMultiAlternatives

subject, from_email, to = 'hello', '[email protected]', '[email protected]'
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()

msg = EmailMessage(subject, html_content, from_email, [to])
msg.content_subtype = "html"  # 主内体现在变成 text/html
msg.send()

Email backends 邮件发送后端

实际上发送邮件的工作是由邮件发送后端处理的。

邮件后端类有下列方法：

• open() 实例化一个长生命周期的邮件发送链接。
• close() 关闭当前邮件发送链接。
• send_messages(email_messages) 发送一组 EmailMessage 对象的列表。如果链接(connection)还未打开，该调用会隐性地打开链接，发完邮件后就关闭该链接。 如果该链接已经打开，那么它会保持打开状态直至邮件发送完毕。

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'

EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'

EMAIL_BACKEND = 'django.core.mail.backends.filebased.EmailBackend'
EMAIL_FILE_PATH = '/tmp/app-messages' # 将其改为本地的存放目录

EMAIL_BACKEND = 'django.core.mail.backends.locmem.EmailBackend'

EMAIL_BACKEND = 'django.core.mail.backends.dummy.EmailBackend'

from django.core import mail
connection = mail.get_connection()   # 使用默认邮件链接(connection)
messages = get_notification_email()
connection.send_messages(messages)

from django.core import mail
connection = mail.get_connection()

# 手动打开链接(connection)
connection.open()

# 使用该链接构造一个邮件报文
email1 = mail.EmailMessage('Hello', 'Body goes here', '[email protected]',
                          ['[email protected]'], connection=connection)
email1.send() # 发送邮件

# 构造其他两个报文
email2 = mail.EmailMessage('Hello', 'Body goes here', '[email protected]',
                          ['[email protected]'])
email3 = mail.EmailMessage('Hello', 'Body goes here', '[email protected]',
                          ['[email protected]'])

# 在一个调用中发送两封邮件
connection.send_messages([email2, email3])
# 链接已打开，因此 send_messages() 不会关闭链接
# 要手动关闭链接
connection.close()

测试邮件发送

有几种情况下，我们并不想让Django发送邮件。比如：开发网站时，一般不想发送数以千计的邮件，但又想验证一下在正确环境下邮件是否会发送给目标人群， 以及这些邮件内容是否正确。

测试发送邮件的最简单方式就是使用 console 邮件发送后端。它直接将所有邮件输出到stdout，从而可以检查邮件内容是否正确。

file 后端在开发过程中也非常有用–它将每封邮件的内容都写到一个指定的文件中，从而方便检查。

还有一种方式是使用 “dumb” SMTP 服务器，它在本地接收所有邮件，并在终端显示出邮件，但事实上不能发送任何邮件。 Python有一个内置的方式可以实现该服务，只须一条命令行:

python -m smtpd -n -c DebuggingServer localhost:1025

该命令会启动一个简单的SMTP服务器，用以监听本地的1025端口。该服务器简单的将所有邮件的头信息和邮件主体打印到标准输出。 然后只须更改 EMAIL_HOST 和 EMAIL_PORT 即可。

更多关于本地测试和处理邮件的细节资料，请查看Python文档 smtpd 模块。

SMTPConnection

SMTPConnection 类已弃用，转而使用通用邮件后端(backend)API。

出于向上兼容性的考虑， SMTPConnection 仍然保留在 django.core.mail 中，且做为 SMTP backend. 的别名。新代码应该使用 get_connection() 取代。