Djano發送郵件

Note

由 django.core.mail 發送的郵件，其字符集都由 DEFAULT_CHARSET 配置項決定。

send_mass_mail() vs. send_mail()

send_mass_mail() 和 send_mail() 的區別在于： send_mail() 每發送一封郵件就會打開一次郵件服務器鏈接，而send_mass_mail() 則是打開一次鏈接，發送所有的郵件。 send_mass_mail() 明顯更高效。

Note

這是一個設計特性： send_mail() 和其他相關函式是最初只是由Django提供的一組接口。 但是其接收的參數數量卻隨著Django的發展而慢慢增長。這樣就能理解為什么要將郵件報文使用面向對象設計重新設計，同時又保留原有函式以保證后端兼容，

EmailMessage 對象

EmailMessage 類使用下列參數初始化（除非使用位置參數，否則默認順序如下）。所有參數均可選，均可在調用send() 方法之前的任何時間對其賦值。

• subject: 郵件的標題行
• body: 郵件的主體內容文本，須是純文本信息。
• from_email: 發送者的地址。 fred@example.com 或 Fred <fred@example.com> 格式都是合法的。如果忽略該參數，Django就會使用 DEFAULT_FROM_EMAIL 配置項。
• to: 收件人地址列表或元組。
• bcc: 發送郵件時用于”Bcc”頭信息的一組列表或元組，也就是暗送的收件人。
• connection: 一個郵件后端實例。用同一個鏈接發送多封郵件就要用到該參數。忽略該參數時，會在調用 send()時自動創建一個新鏈接。
• attachments: 置于郵件報文內的附件列表。列表元素可以是　``email.MIMEBase.MIMEBase`` 實例，也可以是(filename, content, mimetype) 三部分構成的元組。
• headers: 置于郵件報文內的其他頭信息(header)的字典。字典的key是頭信息的名稱，字典的value是頭信息的值。 這樣做能確保頭信息的名稱和對應值會以正確的格式保存于郵件報文中。
• cc: 發送郵件時放于”Cc”頭信息的一系列列表或元組。

例如:

email = EmailMessage('Hello', 'Body goes here', 'from@example.com',
            ['to1@example.com', 'to2@example.com'], ['bcc@example.com'],
            headers = {'Reply-To': 'another@example.com'})

該類方法如下:

• send(fail_silently=False) 發送郵件報文。如果在構造郵件時如果指定了某個鏈接(connection)，就會使用該鏈接發郵件。 否則，就會使用默認后端的實例發郵件。如果關鍵字參數 fail_silently 為 True ，就會忽略郵件發送時拋出的異常。

• message() 構造了一個 django.core.mail.SafeMIMEText 對象 (Python的 email.MIMEText.MIMEText 類的子類) 或是 django.core.mail.SafeMIMEMultipart 對象（該對象保存即將發送出去郵件報文）。如需擴展EmailMessage 類，一般情況下要覆寫該方法，將你所需的內容添加到MIME對象中。

• recipients() 返回郵件中所有收件人的列表，不管收件人是在 to 還是 bcc 屬性中。這是另一個經常被繼承覆寫的方法， 因為SMTP服務器在發送郵件報文時，要接收完整的收件人列表。即使你自己的類使用其他方式來指定收件人，也仍然需要使用該方法返回收件人列表。

• attach() 創建一個新的文件附件，并把它添加到郵件報文中。 有兩種方法調用 attach():

  • 傳遞一個單獨的 email.MIMEBase.MIMEBase 實例做為參數。該實例會直接添加到最終的郵件報文中。

  • 或者，給 attach() 傳遞三個參數: filename, content 和 mimetype. filename 是出現在郵件中的附件文件的名稱， content 是附件的內容，而 mimetype 是附件所使用的MIME類型。 如果忽略 mimetype, Django會自動根據附件文件名來推測MIME內容類型。

    例如:

    message.attach('design.png', img_data, 'image/png')

• attach_file() 使用當前文件系統下的某個文件做為附件。調用時，傳入某個文件的完整路徑，以及該附件的MIME類型(可選的)。 忽略MIME類型的話，Django會自動根據附件文件名來推測MIME類型。最簡單的用法如下:

  message.attach_file('/images/weather_map.png')

from django.core.mail import EmailMultiAlternatives

subject, from_email, to = 'hello', 'from@example.com', 'to@example.com'
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()

獲取郵件發送后端的實例

django.core.mail 的 get_connection() 函式返回你當前使用的郵件后端的實例。

默認情況下，對 get_connection() 的調用會返回一個郵件后端實例，具體是哪個后端由 EMAIL_BACKEND 配置項決定。 如果指定了``backend`` 參數，就會對該后端進行實例化。

fail_silently 參數決定后端如何處理錯誤。 如果 fail_silently 為 True ，發送郵件進程引發的異常將會被忽略。

其他的所有參數都會被直接傳遞給郵件后端的構造函式

Django提供了幾種不同的郵件發送后端。除了SMTP backend之外（也是默認的郵件發送后端）， 其他后端僅適用于測試和開發過程。如果有特珠的郵件發送要求，可以 編寫自己的郵件發送后端.

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'

自定義郵件發送后端

如果要改變郵件的發送方式，可以自己寫一個郵件發送后端。 將 EMAIL_BACKEND 配置項設為自定義后端的python引用路徑。

自定義郵件后端應該繼承 BaseEmailBackend ，該類位于 django.core.mail.backends.base 模塊。 自定義郵件后端必須實現 send_messages(email_messages) 方法。該方法接收一個列表，列表元素是 EmailMessage 實例，并返回一組發送成功的消息。 如果自定義后端還涉及持久化session或connection，還應該實現 open() 和 close() 方法。smtp.EmailBackend 可以做為一個現成的參考。

發送多封郵件

建立和關閉一個SMTP鏈接(connection)是一個代價高昂的過程（對于這種情況，任何網絡鏈接都是如此）。 因此要想發送更多郵件，重用SMTP鏈接就顯得很有意義；而不是每次發送一封郵件，都要創建和銷毀一個鏈接。

有兩種方式可以重用鏈接。

第一種方式，可以使用 send_messages() 方法。 send_messages() 接收一個 EmailMessage (或是子類)實例的列表， 然后用單獨一個鏈接來發送列表中的內容。

例如，你有一個名為 get_notification_email() 的函式，用以定時發送郵件，它返回一個 EmailMessage 對象的列表。 調用一次 send_messages 就可以發送完這些郵件:

from django.core import mail
connection = mail.get_connection()   # 使用默認郵件鏈接(connection)
messages = get_notification_email()
connection.send_messages(messages)

在這個例子中，調用 send_messages() 會在后端打開一個鏈接(connection)，發送列表中的郵件報文，然后再關閉鏈接。

第二種方式是在郵件后端使用 open() 和 close() 方法手動控制鏈接。 在已經打開鏈接的情況下， send_messages()不會自動打開和關閉鏈接。因此在該情況下，要手動決定何時關閉鏈接。 舉個例子:

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

# 手動打開鏈接(connection)
connection.open()

# 使用該鏈接構造一個郵件報文
email1 = mail.EmailMessage('Hello', 'Body goes here', 'from@example.com',
                          ['to1@example.com'], connection=connection)
email1.send() # 發送郵件

# 構造其他兩個報文
email2 = mail.EmailMessage('Hello', 'Body goes here', 'from@example.com',
                          ['to2@example.com'])
email3 = mail.EmailMessage('Hello', 'Body goes here', 'from@example.com',
                          ['to3@example.com'])

# 在一個調用中發送兩封郵件
connection.send_messages([email2, email3])
# 鏈接已打開，因此 send_messages() 不會關閉鏈接
# 要手動關閉鏈接
connection.close()

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