前言

在Python中已經(jīng)內(nèi)置了一個(gè)smtp郵件發(fā)送模塊，Django在此基礎(chǔ)上進(jìn)行了簡(jiǎn)單地封裝，讓我們?cè)贒jango環(huán)境中可以更方便更靈活的發(fā)送郵件。

所有的功能都在django.core.mail中。

一、快速上手

兩行就可以搞定一封郵件：

from django.core.mail import send_mail

send_mail(
  'Subject here',
  'Here is the message.',
  'from@example.com',
  ['to@example.com'],
  fail_silently=False,
)

導(dǎo)入功能模塊，然后發(fā)送郵件，so easy！

默認(rèn)情況下，使用配置文件中的EMAIL_HOST和EMAIL_PORT設(shè)置SMTP服務(wù)器主機(jī)和端口，EMAIL_HOST_USER和EMAIL_HOST_PASSWORD是用戶名和密碼。如果設(shè)置了EMAIL_USE_TLS和EMAIL_USE_SSL，它們將控制是否使用相應(yīng)的加密鏈接。

二、單發(fā) send_mail()

方法原型：send_mail(subject, message, from_email, recipient_list, fail_silently=False, auth_user=None, auth_password=None, connection=None, html_message=None)[source]

讓我們來(lái)了解一下send_mail()方法，它接收一系列參數(shù)，其中的subject、message、from_email和recipient_list參數(shù)是必須的，其它的可選。

• subject：郵件主題。字符串。
• message：郵件具體內(nèi)容。字符串。
• from_email：郵件發(fā)送者。字符串。
• recipient_list：收件人。一個(gè)由郵箱地址組成的字符串列表。recipient_list中的每一個(gè)成員都會(huì)在郵件信息的“To:”區(qū)域看到其它成員。
• fail_silently: 一個(gè)布爾值。如果它是False，send_mail發(fā)送失敗時(shí)，將會(huì)引發(fā)一個(gè)smtplib.SMTPException異常。
• auth_user: 可選的用戶名用來(lái)驗(yàn)證SMTP服務(wù)器，如果你要特別指定使用哪個(gè)郵箱帳號(hào)，就指定這個(gè)參數(shù)。如果沒(méi)有提供這個(gè)值，Django將會(huì)使用settings中EMAIL_HOST_USER的值。如果兩者都不提供，那你還發(fā)什么？？？
• auth_password: 可選的密碼用來(lái)驗(yàn)證SMTP服務(wù)器。如果沒(méi)有提供這個(gè)值，Django 將會(huì)使用settings中EMAIL_HOST_PASSWORD的值。和上面那個(gè)參數(shù)是一家的。
• connection: 可選的用來(lái)發(fā)送郵件的電子郵件后端。
• html_message: 如果提供了html_message，可以發(fā)送帶HTML代碼的郵件。

send_mail()方法返回值將是成功發(fā)送出去的郵件數(shù)量（只會(huì)是0或1，因?yàn)樗荒馨l(fā)送一封郵件）。

三、群發(fā) send_mass_mail()

方法原型：send_mass_mail（datatuple，fail_silently = False，auth_user = None，auth_password = None ，connection = None）[source]

send_mass_mail()用來(lái)處理大批量郵件任務(wù)，也就是所謂的群發(fā)。

它的參數(shù)中，datatuple是必需參數(shù)，接收一個(gè)元組，元組的每個(gè)元素的格式如下：

(subject, message, from_email, recipient_list)
上面四個(gè)字段的意義與send_mail()中的相同。

例如，以下代碼將向兩組不同的收件人發(fā)送兩個(gè)不同的消息；但是，只能打開(kāi)一個(gè)到郵件服務(wù)器的連接：

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)

send_mass_mail()方法的返回值是成功發(fā)送的郵件數(shù)量。

使用send_mail()方法時(shí)，每調(diào)用一次，它會(huì)和SMTP服務(wù)器建立一次連接，也就是發(fā)一次連一次，效率很低。而send_mass_mail()，則只建立一次鏈接，就將所有的郵件都發(fā)送出去，效率比較高。

四、防止頭部注入攻擊

有時(shí)候，我們要根據(jù)用戶表單的輸入來(lái)構(gòu)造電子郵件，這就存在頭部注入攻擊的風(fēng)險(xiǎn)，Django給我們提供了一定的防范能力，但是更多時(shí)候，還需要你自己編寫安全防范代碼。

下面是一個(gè)例子，接收用戶輸入的主題、郵件內(nèi)容和發(fā)送方，將郵件發(fā)送到系統(tǒng)管理員：

from django.core.mail import send_mail, BadHeaderError
from django.http import HttpResponse, HttpResponseRedirect

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

如果檢查到用戶的輸入帶有頭部注入攻擊的可能性，會(huì)彈出BadHeaderError異常。

五、發(fā)送多媒體郵件

默認(rèn)情況下，發(fā)送的郵件都是純文本格式的。但有時(shí)候我們希望能在郵件里帶一些超級(jí)鏈接、圖片，甚至視頻和JS動(dòng)作。

Django為我們提供了一個(gè)EmailMultiAlternatives類，可以同時(shí)發(fā)送文本和HTML內(nèi)容，下面是個(gè)范例，我們照著寫就行：

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

需要提醒的是，接收方的郵件服務(wù)商不一定支持多媒體郵件，也許是為了安全，也許是別的原因。為了保證你的郵件內(nèi)容能被閱讀，請(qǐng)務(wù)必同時(shí)發(fā)送純文本郵件。

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論