在基於互聯網的應用中,程序經常需要自動地發送電子郵件。如:一個網站的註冊系統會在用戶註冊時發送一封郵件來確認註冊;當用戶忘記登陸密碼的時候,通過郵件來取回密碼。smtplib模塊是python中smtp(簡單郵件傳輸協議)的客戶端實現。我們可以使用smtplib模塊,輕鬆的發送電子郵件。下面的例子用了不到十行代碼來發送電子郵件:
- #coding=gbk
- import smtplib
- smtp = smtplib.SMTP()
- smtp.connect("smtp.yeah.net", "25")
- smtp.login('用戶名', '密碼')
- smtp.sendmail('[email protected]', '[email protected]', 'From: [email protected]/r/nTo: [email protected]/r/nSubject: this is a email from python demo/r/n/r/nJust for test~_~')
- smtp.quit()
這個例子夠簡單吧^_^!下面詳細介紹stmplib模塊中的類和方法。
smtplib.SMTP([host[, port[, local_hostname[, timeout]]]])
SMTP類構造函數,表示與SMTP服務器之間的連接,通過這個連接我們可以向smtp服務器發送指令,執行相關操作(如:登陸、發送郵件)。該類提供了許多方法,將在下面介紹。它的所有參數都是可選的,其中host參數表示smtp服務器主機名,上面例子中的smtp主機爲"smtp.yeah.net";port表示smtp服務的端口,默認是25;如果在創建SMTP對象的時候提供了這兩個參數,在初始化的時候會自動調用connect方法去連接服務器。
smtplib模塊還提供了SMTP_SSL類和LMTP類,對它們的操作與SMTP基本一致。
smtplib.SMTP提供的方法:
SMTP.set_debuglevel(level)
設置是否爲調試模式。默認爲False,即非調試模式,表示不輸出任何調試信息。
SMTP.connect([host[, port]])
連接到指定的smtp服務器。參數分別表示smpt主機和端口。注意: 也可以在host參數中指定端口號(如:smpt.yeah.net:25),這樣就沒必要給出port參數。
SMTP.docmd(cmd[, argstring])
向smtp服務器發送指令。可選參數argstring表示指令的參數。下面的例子完全通過調用docmd方法向服務器發送指令來實現郵件的發送(在smtp.yeah.net郵件服務器上試驗通過。其他郵件服務器沒有試過):
- import smtplib, base64, time
- userName = base64.encodestring('from').strip()
- password = base64.encodestring('password').strip()
- smtp = smtplib.SMTP()
- smtp.connect("smtp.yeah.net:25")
- print smtp.docmd('helo', 'from')
- print smtp.docmd('auth login')
- print smtp.docmd(userName)
- print smtp.docmd(password)
- print smtp.docmd('mail from:', '<[email protected]>')
- print smtp.docmd('rcpt to:', '<[email protected]>')
- #data 指令表示郵件內容
- print smtp.docmd('data')
- print smtp.docmd('''''from: [email protected]
- to: [email protected]
- subject: subject
- email body
- .
- ''')
- smtp.quit()
SMTP.helo([hostname])
使用"helo"指令向服務器確認身份。相當於告訴smtp服務器“我是誰”。
SMTP.has_extn(name)
判斷指定名稱在服務器郵件列表中是否存在。出於安全考慮,smtp服務器往往屏蔽了該指令。
SMTP.verify(address)
判斷指定郵件地址是否在服務器中存在。出於安全考慮,smtp服務器往往屏蔽了該指令。
SMTP.login(user, password)
登陸到smtp服務器。現在幾乎所有的smtp服務器,都必須在驗證用戶信息合法之後才允許發送郵件。
SMTP.sendmail(from_addr, to_addrs, msg[, mail_options, rcpt_options])
發送郵件。這裏要注意一下第三個參數,msg是字符串,表示郵件。我們知道郵件一般由標題,發信人,收件人,郵件內容,附件等構成,發送郵件的時候,要注意msg的格式。這個格式就是smtp協議中定義的格式。在上面的例子中,msg的值爲:
- '''''From: [email protected]
- To: [email protected]
- Subject: test
- just for test'''
這個字符串的的意思表示郵件發件人爲"[email protected]",收件人爲" [email protected]",郵件標題爲"test",郵件內容爲"just for test"。細心的你可能會疑問:如果要發送的郵件內容很複雜,包含圖片、視頻、附件等內容,按照MIME的格式來拼接字符串,將是一件非常麻煩的事。不用擔心,python已經考慮到了這點,它爲我們提供了email模塊,使用該模塊可以輕鬆的發送帶圖片、視頻、附件等複雜內容的郵件。在介紹完smtplib模塊之後,我會簡單介紹email模塊的基本使用。
SMTP.quit()
斷開與smtp服務器的連接,相當於發送"quit"指令。
email及其相關子模塊
emial模塊用來處理郵件消息,包括MIME和其他基於RFC 2822 的消息文檔。使用這些模塊來定義郵件的內容,是非常簡單的。下面是一些常用的類:
class email.mime.multipart. MIMEMultipart: 多個MIME對象的集合。
class email.mime.audio. MIMEAudio: MIME音頻對象。
class email.mime.image. MIMEImage: MIME二進制文件對象。
class email.mime.text. MIMEText: MIME文本對象。
看上面的解釋可能會覺得雲裏霧裏,其實我對smtp, MIME的理解也很膚淺。但在大多數時候,我們只要會用就可以了。下面是一個簡單的例子來演示如何使用這些類來發送帶附件的郵件:
- #coding=gbk
- import smtplib, mimetypes
- from email.mime.text import MIMEText
- from email.mime.multipart import MIMEMultipart
- from email.mime.image import MIMEImage
- msg = MIMEMultipart()
- msg['From'] = "[email protected]"
- msg['To'] = '[email protected]'
- msg['Subject'] = 'email for tesing'
- #添加郵件內容
- txt = MIMEText("這是郵件內容~~")
- msg.attach(txt)
- #添加二進制附件
- fileName = r'e:/PyQt4.rar'
- ctype, encoding = mimetypes.guess_type(fileName)
- if ctype is None or encoding is not None:
- ctype = 'application/octet-stream'
- maintype, subtype = ctype.split('/', 1)
- att1 = MIMEImage((lambda f: (f.read(), f.close()))(open(fileName, 'rb'))[0], _subtype = subtype)
- att1.add_header('Content-Disposition', 'attachment', filename = fileName)
- msg.attach(att1)
- #發送郵件
- smtp = smtplib.SMTP()
- smtp.connect('smtp.yeah.net:25')
- smtp.login('from', '密碼')
- smtp.sendmail('[email protected]', '[email protected]', msg.as_string())
- smtp.quit()
- print '郵件發送成功'
是不是很簡單。簡單就是美,用最少的代碼把問題解決,這就是Python。更多關於smtplib的信息,請參考Python手冊 smtplib模塊。