一、介紹
SMTP(Simple Mail Transfer Protocol)即簡單郵件傳輸協議,它是一組用於由源地址到目的地址傳送郵件的規則,由它來控制信件的中轉方式。
python的smtplib提供了一種很方便的途徑發送電子郵件。它對smtp協議進行了簡單的封裝。
Python內置對SMTP的支持,可以發送純文本郵件、HTML郵件以及帶附件的郵件。
Python對SMTP支持有smtplib和email兩個模塊,email負責構造郵件,smtplib負責發送郵件
二、基礎語法
1、Python創建 SMTP 對象
語法如下:
import smtplib smtpObj = smtplib.SMTP( [host [, port [, local_hostname]]] )
參數說明:
- host: SMTP 服務器主機。 你可以指定主機的ip地址或者域名如: runoob.com,這個是可選參數。
- port: 如果你提供了 host 參數, 你需要指定 SMTP 服務使用的端口號,一般情況下 SMTP 端口號為25。
- local_hostname: 如果 SMTP 在你的本機上,你只需要指定服務器地址為 localhost 即可。
或者:
import smtplib smtpObj = smtplib.SMTP() smtpObj.connect(host, 25) # 25 為 SMTP 端口號 smtpObj.quit()
2、Python SMTP 對象使用 sendmail 方法發送郵件
語法如下:
smtpObj.sendmail(from_addr, to_addrs, msg[, mail_options, rcpt_options])
參數說明:
- from_addr: 郵件發送者地址(即你的郵箱地址)。
- to_addrs: 字符串列表,郵件發送地址(發給誰,即對方郵箱地址)。
- msg: 發送消息
這里要注意一下第三個參數,msg 是字符串,表示郵件。我們知道郵件一般由標題,發信人,收件人,郵件內容,附件等構成,發送郵件的時候,要注意 msg 的格式。這個格式就是 smtp 協議中定義的格式。
三、純文本郵件示例
1、基礎語法
""" 如果本機已經安裝了支持SMTP服務,如sendemail, 我們使用三個引號來設置郵件信息,標准郵件需要三個頭部信息: From, To, 和 Subject ,每個信息直接使用空行分割。 msg['To']接收的是字符串而不是list,如果有多個郵件地址,用,分隔即可。 我們通過實例化 smtplib 模塊的 SMTP 對象 smtpObj 來連接到 SMTP 訪問,並使用 sendmail 方法來發送信息。 執行以上程序,如果你本機安裝 sendmail(郵件傳輸代理程序) """ import smtplib from email.mime.text import MIMEText from email.header import Header sender = 'xxx' # 發送者的郵箱 receivers = ['xxx@qq.com'] # 接收郵件,其他人的郵箱 # 三個參數:第一個為文本內容,第二個為格式 plain 代表文本格式,第三個 utf-8 設置編碼 message = MIMEText('郵件發送測試', 'plain', 'utf-8') # 郵箱內容 message['From'] = Header("ZBJ", '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 訪問,也可以使用其他郵件服務商的 SMTP 訪問(QQ、網易、Google等) """ 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 = 'xxx' # 發送者郵箱 receivers = ['xxx@qq.com'] # 接收郵件,其他人的郵箱 message = MIMEText('郵件發送測.', 'plain', 'utf-8') message['From'] = Header("ZBJ", '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) # 端口根據服務器不同可能會改變 smtpObj.login(mail_user,mail_pass) smtpObj.sendmail(sender, receivers, message.as_string()) print("郵件發送成功") except smtplib.SMTPException: print("Error: 無法發送郵件")
2、純文本郵件示例(QQ郵箱)
QQ郵箱 POP3 和 SMTP 服務器地址設置如下:
郵箱 | POP3服務器(端口995) | SMTP服務器(端口465或587) |
---|---|---|
qq.com | pop.qq.com | smtp.qq.com |
SMTP服務器需要身份驗證。根據提示開啟相關服務,選擇生成授權碼,得到后用於后續代碼登陸部分
首先必須要打開QQ郵箱的smtp服務,在QQ郵箱個人主頁的 設置-賬戶 中開啟。如圖:
成功開啟后點擊生成授權碼 ,得到的密碼為smtp發送郵件時的登錄密碼。
import smtplib from email.mime.text import MIMEText from email.header import Header # 第三方 SMTP 服務 mail_host="smtp.qq.com" # 設置服務器 mail_user="xxx@qq.com" # 用戶名(你的郵箱) mail_pass="yxdfsdwssdftsdg" # 口令,即開啟smtp服務得到的授權碼,不是QQ密碼 sender = "xxx@qq.com" # 發送者的郵箱(也是你的郵箱,同用戶名) receivers = ["yyy@qq.com"] # 接收郵件,其他人郵箱 # 三個參數:第一個為文本內容,第二個為格式 plain 代表文本格式,第三個 utf-8 設置編碼 message = MIMEText("smtplib測試", "plain", "utf-8") # 標准郵件需要三個頭部信息: From, To, 和 Subject message["From"] = Header("ZBJ", "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 端口號 """ 但是這樣我們用25號端口都是以明文發送的,很容易被監視, 所以我們可以發送加密郵件,只需要利用SSL: smtpObj = smtplib.SMTP_SSL() smtpObj.connect(mail_host, 465) # QQ郵箱的端口465或587 SMTP和SMTP_SSL選擇一個使用即可 """ smtpObj.login(mail_user, mail_pass) smtpObj.sendmail(sender, receivers, message.as_string()) print("郵件發送成功") smtpObj.quit() except smtplib.SMTPException: print("Error: 無法發送郵件")
結果如下:
3、使用 formataddr 生成真實的發送/接收者
formataddr 和 parseaddr 用法介紹
from email.utils import parseaddr from email.utils import formataddr # 根據 <> 進行分割,分割出用戶名和郵箱 me = "ZBJ <xxx@qq.com>" ret = parseaddr(me) # 入參是字符串 print(ret) # ('ZBJ', 'xxx@qq.com') # 跟parseaddr相反,把某個列表合並成郵箱格式 f_str = formataddr(["ZBJ", "xxx@qq.com"]) # 入參是列表或者元組 print(f_str) # ZBJ <xxx@qq.com>
上面代碼設置標准郵件的三個頭部信息時,使用的時Header,
Header是自定義的頭部信息,不是真實的,
而使用formataddr則是設置真實的信息。
import smtplib from email.mime.text import MIMEText from email.header import Header from email.utils import formataddr # 第三方 SMTP 服務 mail_host="smtp.qq.com" # 設置服務器 mail_user="xxx@qq.com" # 用戶名 mail_pass="uhadlxasddwsdgq" # 口令 sender = "xxx@qq.com" # 發送者的郵箱 receivers = ["yyy@qq.com"] # 接收郵件,其他人的郵箱 message = MIMEText("嘿嘿嘿", "plain", "utf-8") # 標准郵件需要三個頭部信息: From, To, 和 Subject message["From"] = formataddr(["ZBJ", sender]) # 列表里的對應發件人郵箱昵稱、發件人郵箱賬號 message["To"] = formataddr(["小明", receivers[0]]) # 列表里的對應收件人郵箱昵稱、收件人郵箱賬號 subject = '郵件測試' message['Subject'] = Header(subject, 'utf-8') # 郵件主題 try: smtpObj = smtplib.SMTP_SSL() smtpObj.connect(mail_host, 465) smtpObj.login(mail_user, mail_pass) smtpObj.sendmail(sender, receivers, message.as_string()) print("郵件發送成功") smtpObj.quit() except smtplib.SMTPException: print("Error: 無法發送郵件")
結果如下:
四、HTML格式的郵件示例
Python發送HTML格式的郵件與發送純文本消息的郵件不同之處就是將MIMEText中_subtype設置為html
import smtplib from email.mime.text import MIMEText from email.header import Header # 第三方 SMTP 服務 mail_host="smtp.qq.com" # 設置服務器 mail_user="xxx@qq.com" # 用戶名 mail_pass="ysdfndwfgasd" # 口令 sender = "xxx@qq.com" # 發送者的郵箱 receivers = ["yyy@qq.com"] # 接收郵件,其他人的郵箱 mail_msg = """ <p>HTML郵件測試</p> <table> <thead> <tr> <th>序號</th> <th>姓名</th> <th>愛好</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>小明</td> <td>打球</td> </tr> <tr> <td>2</td> <td>小紅</td> <td>發豪</td> </tr> </tbody> </table> """ # 設置為html郵箱 message = MIMEText(mail_msg, "html", "utf-8") # 標准郵件需要三個頭部信息: From, To, 和 Subject message["From"] = Header("ZBJ", "utf-8") # 發送人 message["To"] = Header("小明", "utf-8") # 接收人 subject = 'HTML郵件測試' message['Subject'] = Header(subject, 'utf-8') # 郵件主題 try: smtpObj = smtplib.SMTP_SSL() smtpObj.connect(mail_host, 465) smtpObj.login(mail_user, mail_pass) smtpObj.sendmail(sender, receivers, message.as_string()) print("郵件發送成功") smtpObj.quit() except smtplib.SMTPException: print("Error: 無法發送郵件")
結果如下:
五、帶附件的郵件
帶附件的郵件可以看做包含若干部分的郵件:文本和各個附件本身,所以,可以構造一個MIMEMultipart
對象代表郵件本身,然后往里面加上一個MIMEText
作為郵件正文,再繼續往里面加上表示附件的MIMEText
對象即可
import smtplib from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart from email.header import Header from email.utils import formataddr # 第三方 SMTP 服務 mail_host = "smtp.qq.com" # 設置服務器 mail_user = "xxx@qq.com" # 用戶名 mail_pass = "ytuasfdwsbsdftwe" # 口令 sender = "xxx@qq.com" # 發送者的郵箱 receivers = ["yyy@qq.com"] # 接收郵件,其他人的郵箱 # 創建一個帶附件的實例 message = MIMEMultipart() message["From"] = formataddr(["ZBJ", sender]) # 發送人 message["To"] = formataddr(["小明", receivers[0]]) # 接收人 subject = '帶附件的郵件測試' message['Subject'] = Header(subject, 'utf-8') # 郵件主題 # 郵件正文內容 message.attach(MIMEText('這是帶附件的郵件發送測試', '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,傳送當前目錄下的 mypicture.png 圖片 att2 = MIMEText(open('mypicture.png', 'rb').read(), 'base64', 'utf-8') att2["Content-Type"] = 'application/octet-stream' att2["Content-Disposition"] = 'attachment; filename="mypicture.png"' message.attach(att2) try: smtpObj = smtplib.SMTP_SSL() smtpObj.connect(mail_host, 465) smtpObj.login(mail_user, mail_pass) smtpObj.sendmail(sender, receivers, message.as_string()) print("郵件發送成功") smtpObj.quit() except smtplib.SMTPException: print("Error: 無法發送郵件")
結果如下:
六、HTML 文本中添加圖片
要把一個圖片嵌入到郵件正文中,如果直接在HTML郵件中鏈接圖片地址是不行的,大部分郵件服務商都會自動屏蔽帶有外鏈的圖片,因為不知道這些鏈接是否指向惡意網站。
要把圖片嵌入到郵件正文中,我們只需按照發送附件的方式,先把郵件作為附件添加進去,然后,在HTML中通過引用src="cid:0"
就可以把附件作為圖片嵌入了。如果有多個圖片,給它們依次編號,然后引用不同的cid:x
即可。
import smtplib from email.mime.text import MIMEText from email.mime.image import MIMEImage from email.mime.multipart import MIMEMultipart from email.header import Header from email.utils import formataddr # 第三方 SMTP 服務 mail_host = "smtp.qq.com" # 設置服務器 mail_user = "xxx@qq.com" # 用戶名 mail_pass = "ytulertyfgbnffd" # 口令 sender = "xxx@qq.com" # 發送者的郵箱 receivers = ["yyy@qq.com"] # 接收郵件,其他人的郵箱 # 創建一個根實例 msgRoot = MIMEMultipart("related") msgRoot["From"] = formataddr(["ZBJ", sender]) # 發送人 msgRoot["To"] = formataddr(["小明", receivers[0]]) # 接收人 subject = 'HTML帶圖片的郵件測試' msgRoot['Subject'] = Header(subject, 'utf-8') # 郵件主題 # 創建一個存放正文的實例,並添加進根實例 msgAlternative = MIMEMultipart('alternative') msgRoot.attach(msgAlternative) mail_msg = """ <p>Python 郵件發送測試...</p> <p>圖片演示:</p> <p><img src="cid:0"></p> """ msgAlternative.attach(MIMEText(mail_msg, 'html', 'utf-8')) # 創建圖片實例,並添加進根實例 fp = open('mypicture.png', 'rb') msgImage = MIMEImage(fp.read()) fp.close() # 定義圖片 ID,在 HTML 文本中引用 msgImage.add_header('Content-ID', '<0>') msgRoot.attach(msgImage) try: smtpObj = smtplib.SMTP_SSL() smtpObj.connect(mail_host, 465) smtpObj.login(mail_user, mail_pass) smtpObj.sendmail(sender, receivers, msgRoot.as_string()) print("郵件發送成功") smtpObj.quit() except smtplib.SMTPException: print("Error: 無法發送郵件")
結果如下: