Django筆記三十八之發送郵件-有解無憂

本文首發于公眾號：Hunter后端

原文鏈接：Django筆記三十八之發送郵件

這一篇筆記介紹如何在 Django 中發送郵件，

在 Python 中，提供了 smtplib 的郵件模塊，而 Django 在這個基礎上對其進行了封裝，我們可以通過 django.core.mail 來呼叫，

以下是本篇筆記的目錄：

郵件配置項
send_mail
EmailMessage
復用郵件發送連接
開發階段除錯設定

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 = '[email protected]'  
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="[email protected]",
    recipient_list=["[email protected]"],
)

在上面的呼叫中，subject 是發送的郵件的標題，

message 是郵件發送的正文內容，

from_email 是發送郵件的郵箱

recipient_list 是接收收件人串列，可以接收多個郵箱地址

對于 message 引數，接收的是純文本資訊，會將引數內容直接顯示在郵件正文，如果是想對文本進行更多操作，比如加大字體，加粗，或者加上表格等操作，可以使用 html_message 引數來替代 message 引數，

比如：

send_mail(
    subject="subject 主題",
    from_email="[email protected]",
    recipient_list=["[email protected]"],
    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", "[email protected]", ["[email protected]"])
message_2 = ("郵件標題2", "郵件正文2", "[email protected]", ["[email protected]"])
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="[email protected]",
    to=["[email protected]"],
)
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="[email protected]",
    to=["[email protected]"],
    attachments=attachments,
)
email.send()

2. attach() 方法

除了直接在 EmailMessage 實體中添加引數，我們還可以使用 attach() 方法，

示例如下：

email = EmailMessage(
    subject="郵件標題",
    body="郵件主體",
    from_email="[email protected]",
    to=["[email protected]"],
)


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="[email protected]",
    to=["[email protected]"],
)

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="[email protected]",
    to=["[email protected]"],
)
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="[email protected]",
    to=["[email protected]"],
)
email_2 = EmailMessage(
    subject="郵件標題2",
    body="郵件主體2",
    from_email="[email protected]",
    to=["[email protected]"],
)


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="[email protected]",
    to=["[email protected]"],
    connection=connection
)
email_1.send()


email_2 = mail.EmailMessage(
    subject="郵件標題2",
    body="郵件主體2",
    from_email="[email protected]",
    to=["[email protected]"],
)


email_3 = mail.EmailMessage(
    subject="郵件標題3",
    body="郵件主體3",
    from_email="[email protected]",
    to=["[email protected]"],
)
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: [email protected]
To: [email protected]
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 控制臺輸出的內容

如果想獲取更多后端相關文章，可掃碼關注閱讀：

轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/551902.html

標籤：其他

上一篇：【深入淺出 Yarn 架構與實作】6-3 NodeManager 分布式快取

下一篇：返回列表