1. 程式人生 > 其它 >詳細講解用Python傳送SMTP郵件的教程

詳細講解用Python傳送SMTP郵件的教程

SMTP是傳送郵件的協議,Python內建對SMTP的支援,可以傳送純文字郵件、HTML郵件以及帶附件的郵件。

Python對SMTP支援有smtplib和email兩個模組,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 = raw_input('From: ')
    password = raw_input('Password: ')
    # 輸入SMTP伺服器地址:
    smtp_server = raw_input('SMTP server: ')
    # 輸入收件人地址:
    to_addr = raw_input('To: ')
    
    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,郵件正文是一個str,as_string()把MIMEText物件變成str。

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

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

  • 郵件沒有主題;
  • 收件人的名字沒有顯示為友好的名字,比如Mr Green [email protected]
  • 明明收到了郵件,卻提示不在收件人中。

這是因為郵件主題、如何顯示發件人、收件人等資訊並不是通過SMTP協議發給MTA,而是包含在發給MTA的文字中的,所以,我們必須把From、To和Subject新增到MIMEText中,才是一封完整的郵件:

    # -*- coding: utf-8 -*-
    
    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.encode('utf-8') if isinstance(addr, unicode) else addr))
    
    from_addr = raw_input('From: ')
    password = raw_input('Password: ')
    to_addr = raw_input('To: ')
    smtp_server = raw_input('SMTP server: ')
    
    msg = MIMEText('hello, send by Python...', 'plain', 'utf-8')
    msg['From'] = _format_addr(u'Python愛好者 <%s>' % from_addr)
    msg['To'] = _format_addr(u'管理員 <%s>' % to_addr)
    msg['Subject'] = Header(u'來自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
[email protected],因為如果包含中文,需要通過Header物件進行編碼。

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

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

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

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

    From: =?utf-8?b?UHl0aG9u54ix5aW96ICF?= <[email protected]>
    To: =?utf-8?b?566h55CG5ZGY?= <[email protected]>
    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顯示的郵件:

傳送附件

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

    # 郵件物件:
    msg = MIMEMultipart()
    msg['From'] = _format_addr(u'Python愛好者 <%s>' % from_addr)
    msg['To'] = _format_addr(u'管理員 <%s>' % to_addr)
    msg['Subject'] = Header(u'來自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)傳送出去,就可以收到如下帶附件的郵件:

傳送圖片

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

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

把上面程式碼加入MIMEMultipart的MIMEText從plain改為html,然後在適當的位置引用圖片:

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

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

同時支援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文件檢視它們所在的包以及詳細的用法。

原始碼參考:

https://github.com/michaelliao/learn-python/tree/master/email