Python3 SMTP發送郵件

SMTP(Simple Mail Transfer Protocol)即簡單郵件傳輸協定,它是一組用於由源地址到目的地址傳送郵件的規則,由它來控制信件的中轉方式。

python的smtplib提供了一種很方便的途徑發送電郵。它對smtp協定進行了簡單的封裝。

Python建立 SMTP 物件語法如下:

import smtplib

smtpObj = smtplib.SMTP( [host [, port [, local_hostname]]] )

引數說明:

  • host: SMTP 伺服器主機。 你可以指定主機的ip地址或者網域名稱如:twcode01.com,這個是可選引數。
  • port: 如果你提供了 host 引數, 你需要指定 SMTP 服務使用的埠號,一般情況下SMTP埠號為25。
  • local_hostname: 如果SMTP在你的本機上,你只需要指定伺服器地址為 localhost 即可。

Python SMTP物件使用sendmail方法發送郵件,語法如下:

SMTP.sendmail(from_addr, to_addrs, msg[, mail_options, rcpt_options]

引數說明:

  • from_addr: 郵件發送者地址。
  • to_addrs: 字串串列,郵件發送地址。
  • msg: 發送訊息

這裡要注意一下第三個引數,msg是字串,表示郵件。我們知道郵件一般由標題,發信人,收件人,郵件內容,附件等構成,發送郵件的時候,要注意msg的格式。這個格式就是smtp協定中定義的格式。

範例

以下是一個使用Python發送郵件簡單的範例:

範例

#!/usr/bin/python3 import smtplib from email.mime.text import MIMEText from email.header import Header sender = 'from@twcode01.com' receivers = ['429240967@qq.com'] # 接收郵件,可設定為你的QQ郵箱或者其他郵箱 # 三個引數:第一個為文字內容,第二個 plain 設定文字格式,第三個 utf-8 設定編碼 message = MIMEText('Python 郵件發送測試...', 'plain', 'utf-8') message['From'] = Header("線上程式語言教學練習", 'utf-8') # 發送者 message['To'] = Header("測試", 'utf-8') # 接收者 subject = 'Python SMTP 郵件測試' message['Subject'] = Header(subject, 'utf-8') try: smtpObj = smtplib.SMTP('localhost') smtpObj.sendmail(sender, receivers, message.as_string()) print ("郵件發送成功") except smtplib.SMTPException: print ("Error: 無法發送郵件")

我們使用三個引號來設定郵件訊息,標準郵件需要三個頭部訊息: From, To, 和 Subject ,每個訊息直接使用空行分割。

我們透過例項化 smtplib 模組的 SMTP 物件 smtpObj 來連接到 SMTP 存取,並使用 sendmail 方法來發送訊息。

執行以上程式,如果你本機安裝sendmail,就會輸出:

$ python3 test.py 
郵件發送成功

檢視我們的收件箱(一般在垃圾箱),就可以檢視到郵件訊息:

如果我們本機沒有 sendmail 存取,也可以使用其他服務商的 SMTP 存取(QQ、網易、Google等)。

範例

#!/usr/bin/python3 import smtplib from email.mime.text import MIMEText from email.header import Header # 第三方 SMTP 服務 mail_host="smtp.XXX.com" #設定伺服器 mail_user="XXXX" #使用者名 mail_pass="XXXXXX" #口令 sender = 'from@twcode01.com' receivers = ['429240967@qq.com'] # 接收郵件,可設定為你的QQ郵箱或者其他郵箱 message = MIMEText('Python 郵件發送測試...', 'plain', 'utf-8') message['From'] = Header("線上程式語言教學練習", 'utf-8') message['To'] = Header("測試", 'utf-8') subject = 'Python SMTP 郵件測試' message['Subject'] = Header(subject, 'utf-8') try: smtpObj = smtplib.SMTP() smtpObj.connect(mail_host, 25) # 25 為 SMTP 埠號 smtpObj.login(mail_user,mail_pass) smtpObj.sendmail(sender, receivers, message.as_string()) print ("郵件發送成功") except smtplib.SMTPException: print ("Error: 無法發送郵件")

使用Python發送HTML格式的郵件

Python發送HTML格式的郵件與發送純文字訊息的郵件不同之處就是將MIMEText中_subtype設定為html。具體程式碼如下:

範例

#!/usr/bin/python3 import smtplib from email.mime.text import MIMEText from email.header import Header sender = 'from@twcode01.com' receivers = ['429240967@qq.com'] # 接收郵件,可設定為你的QQ郵箱或者其他郵箱 mail_msg = """ <p>Python 郵件發送測試...</p> <p><a href="https://www.twcode01.com">這是一個連結</a></p> """ message = MIMEText(mail_msg, 'html', 'utf-8') message['From'] = Header("線上程式語言教學練習", 'utf-8') message['To'] = Header("測試", 'utf-8') subject = 'Python SMTP 郵件測試' message['Subject'] = Header(subject, 'utf-8') try: smtpObj = smtplib.SMTP('localhost') smtpObj.sendmail(sender, receivers, message.as_string()) print ("郵件發送成功") except smtplib.SMTPException: print ("Error: 無法發送郵件")

執行以上程式,如果你本機安裝sendmail,就會輸出:

$ python3 test.py 
郵件發送成功

檢視我們的收件箱(一般在垃圾箱),就可以檢視到郵件訊息:


Python 發送帶附件的郵件

發送帶附件的郵件,首先要建立MIMEMultipart()例項,然後構造附件,如果有多個附件,可依次構造,最後利用smtplib.smtp發送。

範例

#!/usr/bin/python3 import smtplib from email.mime.text import MIMEText from email.mime.multipart import MIMEMultipart from email.header import Header sender = 'from@twcode01.com' receivers = ['429240967@qq.com'] # 接收郵件,可設定為你的QQ郵箱或者其他郵箱 #建立一個帶附件的例項 message = MIMEMultipart() message['From'] = Header("線上程式語言教學練習", 'utf-8') message['To'] = Header("測試", 'utf-8') subject = 'Python SMTP 郵件測試' message['Subject'] = Header(subject, 'utf-8') #郵件正文內容 message.attach(MIMEText('這是線上程式語言教學練習Python 郵件發送測試……', 'plain', 'utf-8')) # 構造附件1,傳送當前目錄下的 test.txt 檔案 att1 = MIMEText(open('test.txt', 'rb').read(), 'base64', 'utf-8') att1["Content-Type"] = 'application/octet-stream' # 這裡的filename可以任意寫,寫什麼名字,郵件中顯示什麼名字 att1["Content-Disposition"] = 'attachment; filename="test.txt"' message.attach(att1) # 構造附件2,傳送當前目錄下的 twcode01.txt 檔案 att2 = MIMEText(open('twcode01.txt', 'rb').read(), 'base64', 'utf-8') att2["Content-Type"] = 'application/octet-stream' att2["Content-Disposition"] = 'attachment; filename="twcode01.txt"' message.attach(att2) try: smtpObj = smtplib.SMTP('localhost') smtpObj.sendmail(sender, receivers, message.as_string()) print ("郵件發送成功") except smtplib.SMTPException: print ("Error: 無法發送郵件")
$ python3 test.py 
郵件發送成功

檢視我們的收件箱(一般在垃圾箱),就可以檢視到郵件訊息:


在 HTML 文字中新增圖片

郵件的 HTML 文字中一般郵件服務商新增外鏈是無效的,正確新增圖片的例項如下所示:

範例

#!/usr/bin/python3 import smtplib from email.mime.image import MIMEImage from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.header import Header sender = 'from@twcode01.com' receivers = ['429240967@qq.com'] # 接收郵件,可設定為你的QQ郵箱或者其他郵箱 msgRoot = MIMEMultipart('related') msgRoot['From'] = Header("線上程式語言教學練習", 'utf-8') msgRoot['To'] = Header("測試", 'utf-8') subject = 'Python SMTP 郵件測試' msgRoot['Subject'] = Header(subject, 'utf-8') msgAlternative = MIMEMultipart('alternative') msgRoot.attach(msgAlternative) mail_msg = """ <p>Python 郵件發送測試...</p> <p><a href="https://www.twcode01.com">線上程式語言教學練習連結</a></p> <p>圖片演示:</p> <p><img src="cid:image1"></p> """ msgAlternative.attach(MIMEText(mail_msg, 'html', 'utf-8')) # 指定圖片為當前目錄 fp = open('test.png', 'rb') msgImage = MIMEImage(fp.read()) fp.close() # 定義圖片 ID,在 HTML 文字中引用 msgImage.add_header('Content-ID', '<image1>') msgRoot.attach(msgImage) try: smtpObj = smtplib.SMTP('localhost') smtpObj.sendmail(sender, receivers, msgRoot.as_string()) print ("郵件發送成功") except smtplib.SMTPException: print ("Error: 無法發送郵件")
$ python3 test.py 
郵件發送成功

檢視我們的收件箱(如果在垃圾箱可能需要移動到收件箱才可正常顯示),就可以檢視到郵件訊息:


使用第三方 SMTP 服務發送

這裡使用了 QQ 郵箱(你也可以使用 163,Gmail等)的 SMTP 服務,需要做以下配置:

QQ 郵箱透過生成授權碼來設定密碼:

QQ 郵箱 SMTP 伺服器地址:smtp.qq.com,ssl 連接埠:465。

以下例項你需要修改:發件人郵箱(你的QQ郵箱),密碼,收件人郵箱(可發給自己)。

QQ SMTP

#!/usr/bin/python3 import smtplib from email.mime.text import MIMEText from email.utils import formataddr my_sender='429240967@qq.com' # 發件人郵箱賬號 my_pass = 'xxxxxxxxxx' # 發件人郵箱密碼 my_user='429240967@qq.com' # 收件人郵箱賬號,我這邊發送給自己 def mail(): ret=True try: msg=MIMEText('填寫郵件內容','plain','utf-8') msg['From']=formataddr(["FromTwcode01",my_sender]) # 括弧里的對應發件人郵箱昵稱、發件人郵箱賬號 msg['To']=formataddr(["FK",my_user]) # 括弧里的對應收件人郵箱昵稱、收件人郵箱賬號 msg['Subject']="線上程式語言教學練習發送郵件測試" # 郵件的主題,也可以說是標題 server=smtplib.SMTP_SSL("smtp.qq.com", 465) # 發件人郵箱中的SMTP伺服器,連接埠是25 server.login(my_sender, my_pass) # 括弧中對應的是發件人郵箱賬號、郵箱密碼 server.sendmail(my_sender,[my_user,],msg.as_string()) # 括弧中對應的是發件人郵箱賬號、收件人郵箱賬號、發送郵件 server.quit() # 關閉連接 except Exception: # 如果 try 中的敘述沒有執行,則會執行下面的 ret=False ret=False return ret ret=mail() if ret: print("郵件發送成功") else: print("郵件發送失敗")
$ python test.py 
郵件發送成功

發送成功後,登陸收件人郵箱即可檢視:

更多內容請參閱:https://docs.python.org/3/library/email-examples.html