学步园

入门例子

只有两行:

from django.core.mail import send_mail

send_mail(u'邮件标题', u'邮件内容', 'from@example.com',
    ['to@example.com'], fail_silently=False)

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

send_mail()

send_mail(subject, message, from_email, recipient_list, fail_silently=False, auth_user=None,auth_password=None, connection=None)

发邮件的最便捷方式就是使用 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()

send_mass_mail(datatuple, fail_silently=False, auth_user=None, auth_password=None,connection=None)

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', '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)

mail_admins()

mail_admins(subject, message, fail_silently=False, connection=None, html_message=None)

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()

mail_managers(subject, message, fail_silently=False, connection=None,html_message=None)

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

例子

该例同时给 john@example.com 和 jane@example.com 发送同一封邮件，这两个邮箱地址都会出现在
“收件人/To:” 一栏:

send_mail('Subject', 'Message.', 'from@example.com',
    ['john@example.com', 'jane@example.com'])

该例则是分别为 john@example.com 和 jane@example.com 分别发送同一封邮件，每人收到的邮件只显示唯一一个收件人:

datatuple = (
    ('Subject', 'Message.', 'from@example.com', ['john@example.com']),
    ('Subject', 'Message.', 'from@example.com', ['jane@example.com']),
)
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, ['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.')

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', 'from@example.com',
            ['to1@example.com', 'to2@example.com'], ['bcc@example.com'],
            headers = {'Reply-To': 'another@example.com'})