在基於網際網路的應用中,程式經常需要自動地傳送電子郵件。如:一個網站的註冊系統會在使用者註冊時傳送一封郵件來確認註冊;當使用者忘記登陸密碼的時候,通過郵件來取回密碼。smtplib模組是python中smtp(簡單郵件傳輸協議)的客戶端實現。我們可以使用smtplib模組,輕鬆的傳送電子郵件。下面的例子用了不到十行程式碼來傳送電子郵件:
1 2 3 4 5 6 7 8 9 |
#coding=gbk import smtplib smtp = smtplib.SMTP() smtp.connect("smtp.yeah.net", "25") smtp.login('使用者名稱', '密碼') smtp.sendmail('from@yeah.net', 'to@21cn.com', 'From: from@yeah.net/r/nTo: to@21cn.com/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郵件伺服器上試驗通過。其他郵件伺服器沒有試過):
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
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:', '<from@yeah.net>') print smtp.docmd('rcpt to:', '<from@yeah.net>') #data 指令表示郵件內容 print smtp.docmd('data') print smtp.docmd('''''from: from@yeah.net to: from@yeah.net 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的值為:
1 2 3 4 5 |
'''''From: from@yeah.net To: to@21cn.com Subject: test just for test''' |
這個字串的的意思表示郵件發件人為”from@yeah.net”,收件人為” to@21cn.com”,郵件標題為”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的理解也很膚淺。但在大多數時候,我們只要會用就可以了。下面是一個簡單的例子來演示如何使用這些類來傳送帶附件的郵件:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 |
#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'] = "from@yeah.net" msg['To'] = 'to@21cn.com' 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('from@yeah.net', 'to@21cn.com', msg.as_string()) smtp.quit() print '郵件傳送成功' |
是不是很簡單。簡單就是美,用最少的程式碼把問題解決,這就是Python。更多關於smtplib的資訊,請參考Python手冊 smtplib模組。