Django 简明教程

Django - Sending E-mails

Django 带有一个使用方便的电子邮件发送引擎。与 Python 类似，您需要导入 smtplib。在 Django 中，您只需导入 django.core.mail。若要开始发送电子邮件，请编辑您的项目 settings.py 文件并设置以下选项 −

EMAIL_HOST − smtp server.
EMAIL_HOST_USER − smtp 服务器的登录证书。
EMAIL_HOST_PASSWORD − smtp 服务器的密码证书。
EMAIL_PORT − smtp 服务器端口。
EMAIL_USE_TLS or _SSL − 如果连接安全，则为 True。

Sending a Simple E-mail

让我们创建一个 "sendSimpleEmail" 视图以发送简单电子邮件。

from django.core.mail import send_mail
from django.http import HttpResponse

def sendSimpleEmail(request,emailto):
   res = send_mail("hello paul", "comment tu vas?", "paul@polo.com", [emailto])
   return HttpResponse('%s'%res)

以下是 send_mail 参数的详细信息 −

subject − E-mail subject.
message − E-mail body.
from_email − E-mail from.
recipient_list − 收件人电子邮件地址列表。
fail_silently − 布尔值，如果为 False，则 send_mail 将在发生错误时引发异常。
auth_user − 如果未在 settings.py 中设置，则为用户登录名。
auth_password − 如果未在 settings.py 中设置，则为用户密码。
connection − E-mail backend.
html_message −（Django 1.7 中的新增内容）如果存在，电子邮件将是 multipart/alternative。

让我们创建一个 URL 以访问我们的视图 −

from django.conf.urls import patterns, url

urlpatterns = paterns('myapp.views', url(r'^simpleemail/(?P<emailto>
   [\w.%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,4})/',
   'sendSimpleEmail' , name = 'sendSimpleEmail'),)

因此，当访问 /myapp/simpleemail/polo@gmail.com 时，您将获得以下页面 −

Sending Multiple Mails with send_mass_mail

该方法返回成功传送消息的数量。这与 send_mail 相同，但需要额外一个参数；datatuple，然后我们的 sendMassEmail 视图将变为 −

from django.core.mail import send_mass_mail
from django.http import HttpResponse

def sendMassEmail(request,emailto):
   msg1 = ('subject 1', 'message 1', 'polo@polo.com', [emailto1])
   msg2 = ('subject 2', 'message 2', 'polo@polo.com', [emailto2])
   res = send_mass_mail((msg1, msg2), fail_silently = False)
   return HttpResponse('%s'%res)

让我们创建一个 URL 以访问我们的视图 −

from django.conf.urls import patterns, url

urlpatterns = paterns('myapp.views', url(r'^massEmail/(?P<emailto1>
   [\w.%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,4})/(?P<emailto2>
   [\w.%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,4})', 'sendMassEmail' , name = 'sendMassEmail'),)

当访问 /myapp/massemail/polo@gmail.com/sorex@gmail.com/ 时，我们会得到 −

send_mass_mail 参数详细信息 −

datatuples − 一个元组，其中每个元素类似于 (主题、邮件、发件人电子邮件、收件人列表)。
fail_silently − 布尔值，如果为 False，则 send_mail 将在发生错误时引发异常。
auth_user − 如果未在 settings.py 中设置，则为用户登录名。
auth_password − 如果未在 settings.py 中设置，则为用户密码。
connection − E-mail backend.

如上面的图片中可以看到，两封邮件发送成功。

Note − 在这个范例中，我们使用 Python smtp 调试服务器，可使用以下方法启动：

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

这意味着您发送的所有电子邮件都将打印在 stdout 上，而虚拟服务器在 localhost:1025 上运行。

Sending e-mails to admins and managers using mail_admins and mail_managers methods

这些方法向设置文件 settings.py 的 ADMINS 选项中定义的网站管理员和 MANAGERS 选项中定义的网站管理者发送电子邮件。我们假设 ADMINS 和 MANAGERS 选项如下所示：

ADMINS = (('polo', ' polo@polo.com '),)

MANAGERS = (('popoli', ' popoli@polo.com '),)

from django.core.mail import mail_admins
from django.http import HttpResponse

def sendAdminsEmail(request):
   res = mail_admins('my subject', 'site is going down.')
   return HttpResponse('%s'%res)

上述代码会向 ADMINS 部分中定义的每位管理员发送一封电子邮件。

from django.core.mail import mail_managers
from django.http import HttpResponse

def sendManagersEmail(request):
   res = mail_managers('my subject 2', 'Change date on the site.')
   return HttpResponse('%s'%res)

上述代码会向 MANAGERS 部分中定义的每位管理者发送一封电子邮件。

参数详细信息 −

Subject − E-mail subject.
message − E-mail body.
fail_silently − 布尔值，如果为 False，则 send_mail 将在发生错误时引发异常。
connection − E-mail backend.
html_message −（Django 1.7 中的新增内容）如果存在，电子邮件将是 multipart/alternative。

Sending HTML E-mail

在 Django >= 1.7 中发送 HTML 邮件如同以下代码所示：

from django.core.mail import send_mail

from django.http import HttpResponse
   res = send_mail("hello paul", "comment tu vas?", "paul@polo.com",
         ["polo@gmail.com"], html_message=")

这会生成一个 multipart/alternative 电子邮件。

但是，在 Django < 1.7 中，要通过使用 django.core.mail.EmailMessage 类向对象调用“send”来发送 HTML 邮件 −

让我们创建一个“sendHTMLEmail”视图来发送 HTML 邮件。

from django.core.mail import EmailMessage
from django.http import HttpResponse

def sendHTMLEmail(request , emailto):
   html_content = "<strong>Comment tu vas?</strong>"
   email = EmailMessage("my subject", html_content, "paul@polo.com", [emailto])
   email.content_subtype = "html"
   res = email.send()
   return HttpResponse('%s'%res)

EmailMessage 类创建的参数详细信息 −

Subject − E-mail subject.
message − 以 HTML 表示的电子邮件正文。
from_email − E-mail from.
to − 收件人的电子邮件地址列表。
bcc − “密件抄送”收件人的电子邮件地址列表。
connection − E-mail backend.

让我们创建一个 URL 以访问我们的视图 −

from django.conf.urls import patterns, url

urlpatterns = paterns('myapp.views', url(r'^htmlemail/(?P<emailto>
   [\w.%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,4})/',
   'sendHTMLEmail' , name = 'sendHTMLEmail'),)

访问 /myapp/htmlemail/polo@gmail.com 时，会得到 −

Sending E-mail with Attachment

这是通过在 EmailMessage 对象上使用“attach”方法来完成的。

发送带附件的电子邮件的视图为：

from django.core.mail import EmailMessage
from django.http import HttpResponse

def sendEmailWithAttach(request, emailto):
   html_content = "Comment tu vas?"
   email = EmailMessage("my subject", html_content, "paul@polo.com", emailto])
   email.content_subtype = "html"

   fd = open('manage.py', 'r')
   email.attach('manage.py', fd.read(), 'text/plain')

   res = email.send()
   return HttpResponse('%s'%res)

附加参数的详情：

filename - 要附加的文件的名称。
content - 要附加的文件的内容。
mimetype - 附件的内容 MIMEType。