Python網絡編程:SMTP發送電子郵件

SMTP 發送電子郵件

來源:廖雪峯的官方網站

SMTP是發送郵件的協議,Python內置對SMTP的支持,可以發送純文本郵件、HTML郵件以及帶附件的郵件。

Python對SMTP支持有smtplibemail兩個模塊,email負責構造郵件,smtplib負責發送郵件。

首先,我們來構造一個最簡單的純文本郵件:

from email.mime.text import MIMEText
msg = MIMEText('hello, send by Python...', 'plain', 'utf-8')

注意到構造MIMEText對象時,第一個參數就是郵件正文,第二個參數是MIME的subtype,傳入'plain'表示純文本,最終的MIME就是'text/plain',最後一定要用utf-8編碼保證多語言兼容性。

然後,通過SMTP發出去:

# 輸入Email地址和口令:
from_addr = input('From: ')
password = input('Password: ')
# 輸入收件人地址:
to_addr = input('To: ')
# 輸入SMTP服務器地址:
smtp_server = input('SMTP server: ')

import smtplib
server = smtplib.SMTP(smtp_server, 25) # SMTP協議默認端口是25
server.set_debuglevel(1)
server.login(from_addr, password)
server.sendmail(from_addr, [to_addr], msg.as_string())
server.quit()

我們用set_debuglevel(1)就可以打印出和SMTP服務器交互的所有信息。SMTP協議就是簡單的文本命令和響應。login()方法用來登錄SMTP服務器,sendmail()方法就是發郵件,由於可以一次發給多個人,所以傳入一個list,郵件正文是一個stras_string()MIMEText對象變成str

如果一切順利,就可以在收件人信箱中收到我們剛發送的Email:

send-mail

仔細觀察,發現如下問題:

  1. 郵件沒有主題;
  2. 收件人的名字沒有顯示爲友好的名字,比如Mr Green
  3. 明明收到了郵件,卻提示不在收件人中。

這是因爲郵件主題、如何顯示發件人、收件人等信息並不是通過SMTP協議發給MTA,而是包含在發給MTA的文本中的,所以,我們必須把FromToSubject添加到MIMEText中,纔是一封完整的郵件:

from email import encoders
from email.header import Header
from email.mime.text import MIMEText
from email.utils import parseaddr, formataddr

import smtplib
    
def _format_addr(s):
    name, addr = parseaddr(s)
    return formataddr((Header(name, 'utf-8').encode(), addr))

from_addr = input('From: ')
password = input('Password: ')
to_addr = input('To: ')
smtp_server = input('SMTP server: ')

msg = MIMEText('hello, send by Python...', 'plain', 'utf-8')
msg['From'] = _format_addr('Python愛好者 <%s>' % from_addr)
msg['To'] = _format_addr('管理員 <%s>' % to_addr)
msg['Subject'] = Header('來自SMTP的問候……', 'utf-8').encode()
    
server = smtplib.SMTP(smtp_server, 25)
server.set_debuglevel(1)
server.login(from_addr, password)
server.sendmail(from_addr, [to_addr], msg.as_string())
server.quit()

我們編寫了一個函數_format_addr()來格式化一個郵件地址。注意不能簡單地傳入name,因爲如果包含中文,需要通過Header對象進行編碼。

msg['To']接收的是字符串而不是list,如果有多個郵件地址,用,分隔即可。

再發送一遍郵件,就可以在收件人郵箱中看到正確的標題、發件人和收件人:

mail-with-header

你看到的收件人的名字很可能不是我們傳入的管理員,因爲很多郵件服務商在顯示郵件時,會把收件人名字自動替換爲用戶註冊的名字,但是其他收件人名字的顯示不受影響。

如果我們查看Email的原始內容,可以看到如下經過編碼的郵件頭:

From: =?utf-8?b?UHl0aG9u54ix5aW96ICF?= <xxxxxx@163.com>
To: =?utf-8?b?566h55CG5ZGY?= <xxxxxx@qq.com>
Subject: =?utf-8?b?5p2l6IeqU01UUOeahOmXruWAmeKApuKApg==?=

這就是經過Header對象編碼的文本,包含utf-8編碼信息和Base64編碼的文本。如果我們自己來手動構造這樣的編碼文本,顯然比較複雜。

發送HTML郵件

如果我們要發送HTML郵件,而不是普通的純文本文件怎麼辦?方法很簡單,在構造MIMEText對象時,把HTML字符串傳進去,再把第二個參數由plain變爲html就可以了:

msg = MIMEText('<html><body><h1>Hello</h1>' +
    '<p>send by <a href="http://www.python.org">Python</a>...</p>' +
    '</body></html>', 'html', 'utf-8')

再發送一遍郵件,你將看到以HTML顯示的郵件:

html-mail

發送附件

如果Email中要加上附件怎麼辦?帶附件的郵件可以看做包含若干部分的郵件:文本和各個附件本身,所以,可以構造一個MIMEMultipart對象代表郵件本身,然後往裏面加上一個MIMEText作爲郵件正文,再繼續往裏面加上表示附件的MIMEBase對象即可:

# 郵件對象:
msg = MIMEMultipart()
msg['From'] = _format_addr('Python愛好者 <%s>' % from_addr)
msg['To'] = _format_addr('管理員 <%s>' % to_addr)
msg['Subject'] = Header('來自SMTP的問候……', 'utf-8').encode()

# 郵件正文是MIMEText:
msg.attach(MIMEText('send with file...', 'plain', 'utf-8'))

# 添加附件就是加上一個MIMEBase,從本地讀取一個圖片:
with open('/Users/michael/Downloads/test.png', 'rb') as f:
    # 設置附件的MIME和文件名,這裏是png類型:
    mime = MIMEBase('image', 'png', filename='test.png')
    # 加上必要的頭信息:
    mime.add_header('Content-Disposition', 'attachment', filename='test.png')
    mime.add_header('Content-ID', '<0>')
    mime.add_header('X-Attachment-Id', '0')
    # 把附件的內容讀進來:
    mime.set_payload(f.read())
    # 用Base64編碼:
    encoders.encode_base64(mime)
    # 添加到MIMEMultipart:
    msg.attach(mime)

然後,按正常發送流程把msg(注意類型已變爲MIMEMultipart)發送出去,就可以收到如下帶附件的郵件:

mimemultipart

發送圖片

如果要把一個圖片嵌入到郵件正文中怎麼做?直接在HTML郵件中鏈接圖片地址行不行?答案是,大部分郵件服務商都會自動屏蔽帶有外鏈的圖片,因爲不知道這些鏈接是否指向惡意網站。

要把圖片嵌入到郵件正文中,我們只需按照發送附件的方式,先把郵件作爲附件添加進去,然後,在HTML中通過引用src="cid:0"就可以把附件作爲圖片嵌入了。如果有多個圖片,給它們依次編號,然後引用不同的cid:x即可。

把上面代碼加入MIMEMultipartMIMETextplain改爲html,然後在適當的位置引用圖片:

msg.attach(MIMEText('<html><body><h1>Hello</h1>' +
    '<p><img src="cid:0"></p>' +
    '</body></html>', 'html', 'utf-8'))

再次發送,就可以看到圖片直接嵌入到郵件正文的效果:

email-inline-image

同時支持HTML和Plain格式

如果我們發送HTML郵件,收件人通過瀏覽器或者Outlook之類的軟件是可以正常瀏覽郵件內容的,但是,如果收件人使用的設備太古老,查看不了HTML郵件怎麼辦?

辦法是在發送HTML的同時再附加一個純文本,如果收件人無法查看HTML格式的郵件,就可以自動降級查看純文本郵件。

利用MIMEMultipart就可以組合一個HTML和Plain,要注意指定subtype是alternative

msg = MIMEMultipart('alternative')
msg['From'] = ...
msg['To'] = ...
msg['Subject'] = ...

msg.attach(MIMEText('hello', 'plain', 'utf-8'))
msg.attach(MIMEText('<html><body><h1>Hello</h1></body></html>', 'html', 'utf-8'))
# 正常發送msg對象...

加密SMTP

使用標準的25端口連接SMTP服務器時,使用的是明文傳輸,發送郵件的整個過程可能會被竊聽。要更安全地發送郵件,可以加密SMTP會話,實際上就是先創建SSL安全連接,然後再使用SMTP協議發送郵件。

某些郵件服務商,例如Gmail,提供的SMTP服務必須要加密傳輸。我們來看看如何通過Gmail提供的安全SMTP發送郵件。

必須知道,Gmail的SMTP端口是587,因此,修改代碼如下:

smtp_server = 'smtp.gmail.com'
smtp_port = 587
server = smtplib.SMTP(smtp_server, smtp_port)
server.starttls()
# 剩下的代碼和前面的一模一樣:
server.set_debuglevel(1)
...

只需要在創建SMTP對象後,立刻調用starttls()方法,就創建了安全連接。後面的代碼和前面的發送郵件代碼完全一樣。

如果因爲網絡問題無法連接Gmail的SMTP服務器,請相信我們的代碼是沒有問題的,你需要對你的網絡設置做必要的調整。

小結

使用Python的smtplib發送郵件十分簡單,只要掌握了各種郵件類型的構造方法,正確設置好郵件頭,就可以順利發出。

構造一個郵件對象就是一個Messag對象,如果構造一個MIMEText對象,就表示一個文本郵件對象,如果構造一個MIMEImage對象,就表示一個作爲附件的圖片,要把多個對象組合起來,就用MIMEMultipart對象,而MIMEBase可以表示任何對象。它們的繼承關係如下:

Message
+- MIMEBase
   +- MIMEMultipart
   +- MIMENonMultipart
      +- MIMEMessage
      +- MIMEText
      +- MIMEImage

這種嵌套關係就可以構造出任意複雜的郵件。你可以通過email.mime文檔查看它們所在的包以及詳細的用法。

參考源碼

send_mail.py

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章