[[405764]]

工作中，我們基本上都用過(guò)電子郵件的客戶端，比如說(shuō) OutLook，F(xiàn)oxmail，從配置項(xiàng)可以知道，SMTP 協(xié)議用于發(fā)送郵件，POP3 和 IMAP 協(xié)議用于接收郵件。其實(shí)很多編程語(yǔ)言都有這類(lèi)協(xié)議的實(shí)現(xiàn)，Python 自然也不例外，標(biāo)準(zhǔn)庫(kù) smtplib、poplib、imaplib 是對(duì)應(yīng)協(xié)議的實(shí)現(xiàn)。

至于發(fā)送郵件，不推薦初學(xué)者使用 smtplib，推薦使用 djangomail，具體方法見(jiàn)前文最簡(jiǎn)單的方式發(fā)送郵件，讓程序出錯(cuò)自動(dòng)發(fā)郵件。

今天分享如何使用 poplib、imaplib 來(lái)接收郵件。

你說(shuō)這兩個(gè)都可以用來(lái)收郵件，到底用哪一個(gè)呢?先看下他們的區(qū)別。

POP3 與 IMAP 的區(qū)別

POP3 協(xié)議是 Post Office Protocol 3 的簡(jiǎn)稱(chēng)，即郵局協(xié)議的第 3 個(gè)版本，是 TCP/IP 協(xié)議族中的一員，默認(rèn)端口是110。本協(xié)議主要用于支持使用客戶端遠(yuǎn)程管理在服務(wù)器上的電子郵件。

IMAP 全稱(chēng)是 Internet Mail Access Protocol，即交互式郵件訪問(wèn)協(xié)議，是一個(gè)應(yīng)用層協(xié)議，端口是 143。用來(lái)從本地郵件客戶端訪問(wèn)遠(yuǎn)程服務(wù)器上的郵件。

POP3 工作在傳輸層，而 IMAP 工作中應(yīng)用層，從這一點(diǎn)來(lái)看，IMAP 更為高級(jí)，事實(shí)上正是如此。雖然這兩個(gè)協(xié)議都是從郵件服務(wù)器下載郵件到本地，但是不同的是 IMAP 提供雙向通信，也即在客戶端所作的更改會(huì)反饋給服務(wù)器端，跟服務(wù)器端形成同步，例如刪除郵件，創(chuàng)建文件夾等。而 POP3 是單向通信的，即下載郵件到本地就算了，所作的更改都只是在客戶端，不會(huì)反映到服務(wù)器端。所以使用 IMAP 協(xié)議也會(huì)更便捷，體驗(yàn)更好，更可靠。

因此，如果你希望對(duì)郵件的更改同步到服務(wù)端，那么使用 IMAP，否則使用 POP3

POP3 發(fā)送郵件

以下面的代碼為例，我們來(lái)獲取最新的一封郵件內(nèi)容：

import poplib 
from email.parser import Parser 
from utils import print_info 
import settings 
 
 
# 連接到POP3服務(wù)器: 
server = poplib.POP3(settings.pop3_server) 
# 身份認(rèn)證: 
server.user(settings.email) 
server.pass_(settings.password) 
 
# stat()返回郵件數(shù)量和占用空間: 
print('Messages: %s. Size: %s' % server.stat()) 
# list()返回所有郵件的編號(hào): 
resp, mails, octets = server.list() 
# 可以查看返回的列表類(lèi)似[b'1 82923', b'2 2184', ...] 
 
# 獲取最新一封郵件, 注意索引號(hào)從1開(kāi)始: 
latest_mail_index = len(mails) 
resp, lines, octets = server.retr(latest_mail_index) 
 
# lines存儲(chǔ)了郵件的原始文本的每一行, 
# 可以獲得整個(gè)郵件的原始文本: 
msg_content = b'\r\n'.join(lines).decode('utf-8') 
# 稍后解析出郵件: 
msg = Parser().parsestr(msg_content) 
print_info(msg) 
# 郵件索引號(hào)直接從服務(wù)器刪除郵件 
# server.dele(index) 
# 關(guān)閉連接: 
server.quit() 

執(zhí)行結(jié)果如下：

poplib 收取郵件分兩步：第一步是獲取郵件列表，第二步是用 email 模塊把原始郵件解析為 Message 對(duì)象，然后，用適當(dāng)?shù)男问桨燕]件內(nèi)容展示出來(lái)。print_info 函數(shù)的邏輯比較復(fù)雜，放在了 utils.py 中，完整代碼見(jiàn)文末的鏈接。

基于 poplib 的三方庫(kù)

使用完標(biāo)準(zhǔn)庫(kù) poplib，也使用過(guò)三方庫(kù) zmail，我只想說(shuō)，還是三方庫(kù)用起來(lái)爽。

zmail

Zmail 使得在 Python3 中發(fā)送和接受郵件變得更簡(jiǎn)單。你不需要手動(dòng)添加服務(wù)器地址、端口以及適合的協(xié)議，zmail 會(huì)幫你完成。此外，使用一個(gè)字典來(lái)代表郵件內(nèi)容也更符合直覺(jué)。

Zmail 僅支持 Python3，不依賴(lài)任何三方庫(kù)。安裝方法：

pip install zmail 

特性：

• 自動(dòng)尋找服務(wù)器地址以及端口
• 自動(dòng)使用可靠的鏈接協(xié)議
• 自動(dòng)將一個(gè)python字典映射成MIME對(duì)象(帶有附件的)
• 自動(dòng)添加頭文件以及l(fā)ocalhostname來(lái)避免服務(wù)器拒收你的郵件
• 輕松自定義你的頭文件
• 支持使用HTML作為郵件內(nèi)容
• 僅需 python>=3.5，你可以將其嵌入你的項(xiàng)目而無(wú)需其他的依賴(lài)

示例代碼：

import zmail 
server = zmail.server('yourmail@example.com', 'yourpassword') 
 
# Send mail 
server.send_mail('yourfriend@example.com',{'subject':'Hello!','content_text':'By zmail.'}) 
# Or to a list of friends. 
server.send_mail(['friend1@example.com','friend2@example.com'],{'subject':'Hello!','content_text':'By zmail.'}) 
 
# Retrieve mail 
latest_mail = server.get_latest() 
zmail.show(latest_mail) 

可以看出，接收最新的郵件只需要兩行代碼：

latest_mail = server.get_latest() 
zmail.show(latest_mail) 

執(zhí)行結(jié)果如下：

很簡(jiǎn)潔，很好用。

文檔：https://github.com/zhangyunhao116/zmail/blob/master/README-cn.md

imap 接收郵件

很多主流郵箱如 163，qq 郵箱默認(rèn)關(guān)閉了 imap 的服務(wù)，可手動(dòng)前往郵箱賬戶設(shè)置頁(yè)面開(kāi)啟，并生成授權(quán)碼，授權(quán)碼就是代碼中用于登錄的密碼。

獲取最新的郵件并展示：

import imaplib 
import email  #導(dǎo)入兩個(gè)庫(kù) 
import settings 
from utils import print_info 
 
M = imaplib.IMAP4_SSL(host = settings.imap_server) 
print('已連接服務(wù)器') 
M.login(settings.email,settings.password) 
print('已登陸') 
print(M.noop()) 
M.select() 
 
typ, data = M.search(None, 'ALL') 
for num in data[0].split(): 
    typ, data = M.fetch(num, '(RFC822)') 
    # print('Message %s\n%s\n' % (num, data[0][1])) 
    # print(data[0][1].decode('utf-8')) 
    msg = email.message_from_string(data[0][1].decode('utf-8')) 
    print_info(msg) 
    break 
M.close() 
M.logout() 

運(yùn)行結(jié)果如下：

基于 imaplib 的三方庫(kù)

你可能會(huì)問(wèn)：為什么要為 Python 創(chuàng)建另一個(gè) IMAP 客戶端庫(kù)?Python 標(biāo)準(zhǔn)庫(kù)不是已經(jīng)有 imaplib 了嗎?。

imaplib 的問(wèn)題在于它非常底層。使用起來(lái)相當(dāng)復(fù)雜，你可能需要處理很多細(xì)節(jié)問(wèn)題，由于 IMAP 服務(wù)器響應(yīng)可能非常復(fù)雜，這意味著使用 imaplib 的每個(gè)人最終都會(huì)編寫(xiě)自己的脆弱解析程序。

此外，imaplib 沒(méi)有很好地利用異常。這意味著您需要檢查 imaplib 的每次調(diào)用的返回值，以查看請(qǐng)求是否成功。下面推薦兩個(gè)常用的三方庫(kù)。

imapclient

imapclient 在內(nèi)部使用的 imaplib，但比 imaplib 好用的多，示例代碼如下：

import ssl 
from imapclient import IMAPClient 
import settings 
# context manager ensures the session is cleaned up 
 
 
ssl_context = ssl.create_default_context() 
# don't check if certificate hostname doesn't match target hostname 
ssl_context.check_hostname = False 
# don't check if the certificate is trusted by a certificate authority 
ssl_context.verify_mode = ssl.CERT_NONE 
 
with IMAPClient(host=settings.imap_server,ssl_context=ssl_context) as client: 
    client.login(settings.account,settings.password) 
    select_info = client.select_folder('INBOX') 
    print('%d messages in INBOX' % select_info[b'EXISTS']) 
    # search criteria are passed in a straightforward way 
    # (nesting is supported) 
    messages = client.search(['FROM', 'xxxx@163.com']) 
    # `response` is keyed by message id and contains parsed, 
    # converted response items. 
    for message_id, data in client.fetch(messages, ['ENVELOPE']).items(): 
        envelope = data[b'ENVELOPE'] 
        print('{id}: subject: {subject} date: {date}'.format( 
            id=message_id, 
            subject = envelope.subject.decode(), 
            date = envelope.date 
        )) 

文檔：https://github.com/mjs/imapclient

imap_tools

通過(guò) IMAP 處理電子郵件和郵箱，支持以下功能：

• 解析的電子郵件消息屬性
• 用于搜索電子郵件的查詢(xún)生成器
• 使用電子郵件的操作：復(fù)制、刪除、標(biāo)記、移動(dòng)、看到、追加
• 使用文件夾的操作：列表、設(shè)置、獲取、創(chuàng)建、存在、重命名、刪除、狀態(tài)

沒(méi)有依賴(lài)項(xiàng)

pip install imap-tools 

示例代碼：

from imap_tools import MailBox, AND 
 
# get list of email subjects from INBOX folder 
with MailBox('imap.mail.com').login('test@mail.com', 'pwd') as mailbox: 
    subjects = [msg.subject for msg in mailbox.fetch()] 
 
# get list of email subjects from INBOX folder - equivalent verbose version 
mailbox = MailBox('imap.mail.com') 
mailbox.login('test@mail.com', 'pwd', initial_folder='INBOX')  # or mailbox.folder.set instead 3d arg 
subjects = [msg.subject for msg in mailbox.fetch(AND(all=True))] 
mailbox.logout() 

文檔：https://github.com/ikvk/imap_tools

最后的話

完整示例代碼：https://github.com/somenzz/tutorial/tree/master/email

使用標(biāo)準(zhǔn)庫(kù)有助于我們加深對(duì)郵件協(xié)議細(xì)節(jié)的理解，而三方庫(kù)卻可以不用考慮過(guò)多細(xì)節(jié)，直接上手，標(biāo)準(zhǔn)庫(kù)相當(dāng)于手動(dòng)擋，三方庫(kù)相當(dāng)于自動(dòng)擋，具體用哪個(gè)，選擇最適合自己的就好。