Django笔记三十八之发送邮件

yizhihongxing

本文首发于公众号:Hunter后端

原文链接:Django笔记三十八之发送邮件

这一篇笔记介绍如何在 Django 中发送邮件。

在 Python 中,提供了 smtplib 的邮件模块,而 Django 在这个基础上对其进行了封装,我们可以通过 django.core.mail 来调用。

以下是本篇笔记的目录:

  1. 邮件配置项
  2. send_mail
  3. EmailMessage
  4. 复用邮件发送连接
  5. 开发阶段调试设置

1、邮件配置项

在正式发送邮件前,我们需要在 settings.py 里设置几个参数,如下:

# hunter/settings.py

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.163.com'     
EMAIL_PORT = 465   
EMAIL_HOST_USER = 'hunterxxxx04@163.com'  
EMAIL_HOST_PASSWORD = 'JBDMVIXSHYxxxxx' 
EMAIL_USE_SSL = True
EMAIL_USE_TLS = False

这些配置项在 log 日志记录那一篇笔记中有过介绍,那是我们指定日志等级发送邮件的功能,这里再做一下简单的介绍。

EMAIL_BACKEND 是我们指定的邮箱后端,在后面我们会介绍在开发调试阶段的时候可以设置的其他值

EMAIL_HOST 发送邮箱的主机地址,这里我们使用的是 163 邮箱的地址

EMAIL_PORT EMAIL_HOST 使用的端口

EMAIL_HOST_USER 发件人邮箱地址

EMAIL_HOST_PASSWORD 163 邮箱开启了 SMTP 服务提供的授权码

EMAIL_USE_SSL 与 SMTP 服务器对话时是否使用隐式 TLS 连接,这种类型被称为 SSL,通常在 465 端口使用,这个字段与 EMAIL_USE_TLS 是互相排斥的,只能设置一个为 True

EMAIL_USE_TLS 与 SMTP 服务器对话是否使用 TLS 连接,一般在 587 端口

以上就是在 Django 里使用 163 邮箱的一个配置项示例。

2、send_mail

配置好之后我们就可以尝试发送一下邮件,最简单的使用示例如下:

from django.core.mail import send_mail

send_mail(
    subject="subject 主题",
    message="邮件主体",
    from_email="hunterxx@163.com",
    recipient_list=["120460xxxx@qq.com"],
)

在上面的调用中,subject 是发送的邮件的标题,

message 是邮件发送的正文内容。

from_email 是发送邮件的邮箱

recipient_list 是接收收件人列表,可以接收多个邮箱地址

对于 message 参数,接收的是纯文本信息,会将参数内容直接显示在邮件正文,如果是想对文本进行更多操作,比如加大字体,加粗,或者加上表格等操作,可以使用 html_message 参数来替代 message 参数。

比如:

send_mail(
    subject="subject 主题",
    from_email="hunterxx@163.com",
    recipient_list=["120460xxxx@qq.com"],
    html_message="<h1>html main body</h1>"
)

在这里,html_message 将参数内容当作一个 html 文本进行解析,发送邮件后就可以在接收邮箱看到大号的文本字体了。

发送批量邮件

如果有批量发送邮件的需求,可以使用 send_mass_mail 方法。

from django.core.mail import send_mass_mail

message_1 = ("邮件标题1", "邮件正文1", "hunterxxx@163.com", ["120460xxxx@qq.com"])
message_2 = ("邮件标题2", "邮件正文2", "hunterxxx4@163.com", ["120460xxx6@qq.com"])
send_mass_mail(
    (message_1, message_2)

该方法接收列表参数,其中列表的每一个元素的参数和参数顺序都是固定的,分别是邮件标题,正文,邮件发送人,和邮件接收人列表。

注意: 因为批量发送的参数是固定的,所以并不支持 send_mail 里的 html_message 参数。

3、EmailMessage

前面介绍的 send_mail() 方法简单可用,但是并不支持邮件里的附件、抄送等功能,接下来我们使用 EmailMessage 这个类来实现这些额外的功能。

以下是使用 EmailMessage 实现发送邮件的简单示例:

from django.core.mail import EmailMessage

email = EmailMessage(
    subject="邮件标题",
    body="邮件主体",
    from_email="hunterxxx@163.com",
    to=["120460xxx@qq.com"],
)
email.send()

参数名称与 send_mail() 略有不同,这里的邮件正文是 body,接收人列表为 to。

这里在实例化 EmailMessage 之后,调用 send() 方法即可发送邮件。

除了上面的这些参数,还有 bcc,实现的是密送功能,也是邮件接收人列表,cc 是抄送人列表。

还有 attachments 参数,实现的是附件功能,接下来介绍几种发送附件的方式:

发送附件

1. attachments 参数

我们可以直接在 EmailMessage() 中添加附件参数,attachments 参数接收一个列表,列表元素也是一个列表,内层的这个列表接收三个元素,第一个元素为文件名,第二个元素为文件内容,第三个元素为指定的附件的 MIME 类型,第三个参数省略的话就会参考附件的文件名自动选择。

我们在系统根目录下创建两个文件 a.txt, b.txt,然后实现示例如下:

from django.core.mail import EmailMessage

attachments = []
for file_name in ["./a.txt", "./b.txt"]:
    with open(file_name, "r") as f:
        content = f.read()
        attachments.append((file_name, content))


email = EmailMessage(
    subject="邮件标题",
    body="邮件主体",
    from_email="hunterxxxx@163.com",
    to=["120460xxxx@qq.com"],
    attachments=attachments,
)
email.send()
2. attach() 方法

除了直接在 EmailMessage 实例中添加参数,我们还可以使用 attach() 方法。

示例如下:

email = EmailMessage(
    subject="邮件标题",
    body="邮件主体",
    from_email="hunterxxxx@163.com",
    to=["120460xxxx@qq.com"],
)


file_name_1 = "./a.txt"
f = open(file_name_1, "r")
file_content_1 = f.read()
f.close()


email.attach(file_name_1, file_content_1)
email.send()
3. attach_file() 方法

还有一个方式是使用 attach_file() 方法,参数内容是文件路径+文件名,系统会自动为我们解析该文件:

email = EmailMessage(
    subject="邮件标题",
    body="邮件主体",
    from_email="hunterxxxx@163.com",
    to=["120460xxx@qq.com"],
)

email.attach_file("./b.txt")
email.send()

EmailMessage 发送 html 正文

前面介绍了在 send_mail() 方法可以通过 html_message 的参数发送 html 页面的邮件,在 EmailMessage 也可以实现,但是需要修改 content_subtype 属性。

默认情况下,EmailMessage.content_subtype 是 "plain",我们将其改为 "html" 即可发送 html 页面的邮件。

email = EmailMessage(
    subject="邮件标题",
    body="<h1>邮件主体</h1>",
    from_email="hunterxxxx@163.com",
    to=["120460xxx@qq.com"],
)
email.content_subtype = "html"
email.send()

4、复用邮件发送连接

因为发送邮件涉及到网络连接及可能存在的大量数据的传送,比如附件。

所以,如果是在接口中有发送邮件的需求,我们可以通过 celery 的异步任务实现发送邮件的功能。

而邮件的发送会涉及到 SMTP 连接的创建和关闭,所以复用连接也是一个好的方式。

这里介绍两种方式:

send_messages

send_messages() 方法接收 EmailMessage 实例列表,然后实现批量发送的功能:

from django.core import mail
from django.core.mail import EmailMessage

email_1 = EmailMessage(
    subject="邮件标题1",
    body="邮件主体1",
    from_email="hunterxxxx@163.com",
    to=["120460xxxx@qq.com"],
)
email_2 = EmailMessage(
    subject="邮件标题2",
    body="邮件主体2",
    from_email="hunterxxxx@163.com",
    to=["120460xxxx@qq.com"],
)


connection = mail.get_connection()
messages = [email_1, email_2]
connection.send_messages(messages)

手动控制 connection

我们可以手动控制 connection 的创建和关闭。

from django.core import mail

connection = mail.get_connection()

email_1 = mail.EmailMessage(
    subject="邮件标题1",
    body="邮件主体1",
    from_email="hunterxxx@163.com",
    to=["120460xxx@qq.com"],
    connection=connection
)
email_1.send()


email_2 = mail.EmailMessage(
    subject="邮件标题2",
    body="邮件主体2",
    from_email="hunterxxxx@163.com",
    to=["120460xxxx@qq.com"],
)


email_3 = mail.EmailMessage(
    subject="邮件标题3",
    body="邮件主体3",
    from_email="hunterxxxx@163.com",
    to=["120460xxxx@qq.com"],
)
messages = [email_2, email_3]
connection.send_messages(messages)


connection.close()

在这里,email_1 的调用增加了 connection 参数,email_2 和 email_3 也是使用 connection 进行的批量发送

这个过程中,connection 一直没有关闭,所以复用的是同一个连接,直到最后调用 close() 才算是手动关闭了这个 connection 连接。

5、开发阶段调试设置

在开发阶段,我们调试发送邮件功能的时候,有时候并不想每次都真的发送邮件给指定账户,尽管可能是测试账号,我们有时候只想看一下输出的内容,可以更改邮箱配置的后端

console

我们可以在 settings.py 里设置:

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

这样,在调用我们前面的 send 方法后,系统就不会发送邮件给 to 的接收人列表了,而是会在控制台输出我们的邮件信息:
类似如下:

Content-Type: text/html; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Subject: =?utf-8?b?6YKu5L2qCH6aKY?=
From: hunterxiong04@163.com
To: 120460xxxx@qq.com
Date: Fri, 17 Feb 2023 18:01:21 -0000
Message-ID: 
 <167665688132.1114.884170460108140763@1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.ip6.arpa>


<h1>邮件主体</h1>
-------------------------------------------------------------------------------

filebased

在调试阶段,我们还可以指定将邮件的内容输出到文件,同样的修改邮件后端配置:

EMAIL_BACKEND = 'django.core.mail.backends.filebased.EmailBackend'
EMAIL_FILE_PATH = './emails_file'

这里设置了邮件后端为文件,EMAIL_FILE_PATH 则是指定了邮件内容放到系统根目录下的 emails_file 文件中。

调用了发送邮件的函数后,在这个文件夹下就会多出一个文件,文件内容是我们前面在 console 控制台输出的内容

如果想获取更多后端相关文章,可扫码关注阅读:
image

原文链接:https://www.cnblogs.com/hunterxiong/p/17383195.html

本站文章如无特殊说明,均为本站原创,如若转载,请注明出处:Django笔记三十八之发送邮件 - Python技术站

(0)
上一篇 2023年5月7日
下一篇 2023年5月8日

相关文章

  • python实现用户答题功能

    下面我来详细讲解一下“Python实现用户答题功能”的完整攻略。 1. 准备工作 在开始之前,我们需要先安装以下两个必要的工具: Python:可以从官网下载安装。 PyCharm:可以从官网下载安装。 安装完成后,打开PyCharm,创建一个新的Python项目。 2. 编写代码 2.1 定义问题和答案 首先,我们需要定义一些问题和答案。可以将它们保存在一…

    python 2023年5月19日
    00
  • Notepad++怎么配置python?

    当使用Notepad++编写Python程序时,可以通过配置让其具有Python语言的自动完成和语法高亮功能。下面是Notepad++配合Python的详细配置攻略: 步骤一:安装Python 在配置Notepad++之前,需要在本地安装好Python。Python的官网为:https://www.python.org/downloads/。根据自己的操作系…

    python 2023年5月18日
    00
  • python保留两位小数的3种方法实例

    来讲讲“Python保留两位小数的3种方法实例”的完整攻略。 1. 使用round函数 使用round函数可以很方便地保留指定位数的小数,它的用法如下: round(num, ndigits) 其中,num是需要取小数点后几位的数值,ndigits是要保留的小数位数。例如,要保留小数点后两位,ndigits就应该取2。 下面通过示例说明: num1 = 3.…

    python 2023年6月5日
    00
  • selenium python 实现基本自动化测试的示例代码

    实现基本自动化测试的示例代码有以下几个步骤: 安装selenium和webdriver Selenium是一个自动化测试工具,可以用它来模拟浏览器行为,webdriver是Selenium的一个子模块,负责与浏览器进行交互,并将用户的操作转换为命令。在Python下安装Selenium和WebDriver的方法如下: pip install selenium…

    python 2023年5月19日
    00
  • Python基础异常处理梳理总结

    当我们在编写Python程序时,常常会遇到各种各样的异常情况,比如语法错误、类型错误、文件不存在等。这时就需要使用异常处理机制来处理这些异常,从而保证程序的正确性和稳定性。本文将对Python基础异常处理做一个总结,包括异常的基本语法、常用的异常类型、自定义异常以及异常处理语句try-except、try-except-else和try-except-fin…

    python 2023年5月13日
    00
  • Python3如何将源目录中的图片用MD5命名并可以设定目标目录

    下面是针对这个问题的详细讲解: 1. 生成MD5值 首先需要使用Python3中的hashlib库生成MD5值。以下是一个简单的示例代码: import hashlib def get_md5(filename): m = hashlib.md5() # 初始化哈希算法对象 with open(filename, ‘rb’) as f: while True…

    python 2023年6月3日
    00
  • Numpy中reshape()和resize()方法的区别

    下面是对Numpy中reshape()和resize()方法的详细讲解及说明。 reshape()方法 概述 reshape()方法是将一个数组转化为指定的形状。该方法返回的是一个新的数组,而原数组并没有发生改变。 语法 reshape()方法的语法如下:numpy.reshape(arr, newshape, order=’C’) 参数说明: arr:数组…

    python-answer 2023年3月25日
    00
  • python使用protobufde的过程解析

    以下是关于“Python使用Protobuf的过程解析”的完整攻略: 什么是Protobuf? Protocol Buffers(简称 Protobuf)是由 Google 开发的一种轻量级的数据序列化协议。与 XML 和 JSON 等常见的数据交换格式相比,Protobuf 的效率更高、数据体积更小。根据 Google 官方文档的描述,Protobuf 压…

    python 2023年6月3日
    00
合作推广
合作推广
分享本页
返回顶部