欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

Python使用POP3和SMTP协议收发邮件的示例代码

程序员文章站 2022-12-04 12:21:08
先来了解一下收/发邮件有哪些协议: smtp协议 smtp(simple mail transfer protocol),即简单邮件传输协议。相当于中转站,将邮件发送...

先来了解一下收/发邮件有哪些协议:

smtp协议
smtp(simple mail transfer protocol),即简单邮件传输协议。相当于中转站,将邮件发送到客户端。

pop3协议
pop3(post office protocol 3),即邮局协议的第3个版本,是电子邮件的第一个离线协议标准。该协议把邮件下载到本地计算机,不与服务器同步,缺点是更易丢失邮件或多次下载相同的邮件。

imap协议
imap(internet mail access protocol),即交互式邮件存取协议。该协议连接远程邮箱直接操作,与服务器内容同步。

exchange服务
exchange服务是一个设计完备的邮件服务器产品,提供了通常所需要的全部邮件服务功能。除了常规smtp/pop协议服务之外,它还支持imap4 、ldap和nntp协议。

python内置对smtp/pop3/imap的支持。更多详情请移步python官方教程

smtp发送邮件

python对smtp支持有 smtplibemail 两个模块, email 负责构造邮件, smtplib 负责发送邮件。

构造邮件

构造最简单的纯文本邮件,如下:

from email.mime.text import mimetext

msg = mimetext('hello, send by python...', 'plain', 'utf-8')

注意到构造 mimetext 对象时,第一个参数就是邮件正文,第二个参数是mime的subtype,传入 'plain' 表示纯文本,最终的mime就是 'text/plain' ,最后一定要用 utf-8 编码保证多语言兼容性。

发送邮件

import smtplib

# 输入email地址和口令:
from_addr = 'test_from_addr@qq.com'
password = 'password'
# 输入收件人地址:
to_addr = 'test_to_addr@qq.com'
# 输入smtp服务器地址:
smtp_server = smtp.qq.com

server = smtplib.smtp(smtp_server, 25) # smtp协议默认端口是25
# server.starttls() # 如果是ssl,则用 587 端口,再加上这句代码就行了
server.set_debuglevel(1) # 打印出和smtp服务器交互的所有信息
server.login(from_addr, password) # 登录smtp服务器
server.sendmail(from_addr, [to_addr], msg.as_string()) # 发邮件
server.quit()

sendmail() 方法就是发邮件,由于可以一次发给多个人,所以传入一个 list ,邮件正文是一个 stras_string() 把mimetext对象变成 str

注意:qq邮件等需要手动开通 smtp服务 , 邮箱设置 => 账号 => pop3/smtp服务,如下图:

Python使用POP3和SMTP协议收发邮件的示例代码
Python使用POP3和SMTP协议收发邮件的示例代码

此时,我们就可以收到邮件了,如下:

Python使用POP3和SMTP协议收发邮件的示例代码 

添加邮件标题、收/发件人

邮件主题、显示发件人、收件人等信息并不是通过smtp协议发送的,而是包含在 mimetext 对象中,如下:

from email import encoders
from email.header import header
from email.mime.text import mimetext
from email.utils import parseaddr, formataddr

import smtplib

def _format_addr(s):
 name, addr = parseaddr(s)
 return formataddr((header(name, 'utf-8').encode(), addr))

from_addr = 'test_from_addr@qq.com'
password = 'password'
to_addr = 'test_to_addr@qq.com'
smtp_server = smtp.qq.com

msg = mimetext('hello, send by python...', 'plain', 'utf-8')
msg['from'] = _format_addr('发件人昵称 <%s>' % from_addr)
msg['to'] = _format_addr('收件人昵称 <%s>' % to_addr)
msg['subject'] = header('这是个有主题的邮件', 'utf-8').encode()

server = smtplib.smtp(smtp_server, 25)
server.set_debuglevel(1)
server.login(from_addr, password)
server.sendmail(from_addr, [to_addr], msg.as_string())
server.quit()

收到的邮件,如下:

Python使用POP3和SMTP协议收发邮件的示例代码

收件人并不是我们设置的 “收件人昵称”,是因为很多邮件服务商在显示邮件时,会把收件人名字自动替换为用户注册的名字,这无伤大雅。

发送html邮件

要发送html邮件很简单,在构造 mimetext 对象时,把html字符串传进去,再把第二个参数由 plain 变为 html ,如下:

msg = mimetext('<html><body><h1>hello</h1>' +
 '<p>send by <a href="http://blog.pangao.vip">pangao's blog</a>...</p>' +
 '</body></html>', 'html', 'utf-8')

发送附件

要想发送附件,需要构造一个 mimemultipart 对象代表邮件本身,然后往里面加上一个 mimetext 作为邮件正文,再继续往里面加上表示附件的 mimebase 对象,如下:

from email.mime.multipart import mimemultipart
from email.mime.base import mimebase

# 邮件对象:
msg = mimemultipart()
msg['from'] = _format_addr('发件人昵称 <%s>' % from_addr)
msg['to'] = _format_addr('收件人昵称 <%s>' % to_addr)
msg['subject'] = header('这是个有主题的邮件', 'utf-8').encode()

# 邮件正文是mimetext:
msg.attach(mimetext('send with file...', 'plain', 'utf-8'))

# 添加附件就是加上一个mimebase,从本地读取一个图片:
with open('/users/pangao/downloads/test.png', 'rb') as f:
 # 设置附件的mime和文件名,这里是png类型:
 mime = mimebase('image', 'png', filename='test.png')
 # 加上必要的头信息:
 mime.add_header('content-disposition', 'attachment', filename='test.png')
 mime.add_header('content-id', '<0>')
 mime.add_header('x-attachment-id', '0')
 # 把附件的内容读进来:
 mime.set_payload(f.read())
 # 用base64编码:
 encoders.encode_base64(mime)
 # 添加到mimemultipart:
 msg.attach(mime)

Python使用POP3和SMTP协议收发邮件的示例代码

发送图片

由于 mac 自带的邮件会自动把图片附件插入邮件正文中,所以样式很好看。但是普通邮件可能没这么便捷(抱歉,我没见过普通邮件。。。小小得瑟一下)

如果要把一个图片嵌入到邮件正文中怎么做?直接在html邮件中链接图片地址行不行?答案是,大部分邮件服务商都会自动屏蔽带有外链的图片,因为不知道这些链接是否指向恶意网站。

要把图片嵌入到邮件正文中,我们只需按照发送附件的方式,先把邮件作为附件添加进去,然后,在html中通过引用 src="cid:0" 就可以把附件作为图片嵌入了。如果有多个图片,给它们依次编号,然后引用不同的 cid:x 即可。

把上面代码加入 mimemultipartmimetextplain 改为 html ,然后在适当的位置引用图片,如下:

msg.attach(mimetext('<html><body><h1>hello</h1>' +
 '<p><img src="cid:0"></p>' +
 '</body></html>', 'html', 'utf-8'))

同时支持html和plain格式

如果我们发送html邮件,收件人通过浏览器或者outlook之类的软件是可以正常浏览邮件内容的,但是,如果收件人使用的设备太古老,查看不了html邮件怎么办?

办法是在发送html的同时再附加一个纯文本,如果收件人无法查看html格式的邮件,就可以自动降级查看纯文本邮件。

利用 mimemultipart 就可以组合一个html和plain,要注意指定subtype是 alternative ,如下:

msg = mimemultipart('alternative')
msg['from'] = ...
msg['to'] = ...
msg['subject'] = ...

msg.attach(mimetext('hello', 'plain', 'utf-8'))
msg.attach(mimetext('<html><body><h1>hello</h1></body></html>', 'html', 'utf-8'))
# 正常发送msg对象...

加密smtp

使用标准的25端口连接smtp服务器时,使用的是明文传输,发送邮件的整个过程可能会被窃听。要更安全地发送邮件,可以加密smtp会话,实际上就是先创建ssl安全连接,然后再使用smtp协议发送邮件。

某些邮件服务商,例如gmail,提供的smtp服务必须要加密传输。我们来看看如何通过gmail提供的安全smtp发送邮件。

必须知道,gmail的smtp端口是587,因此,修改代码如下:

smtp_server = 'smtp.gmail.com'
smtp_port = 587
server = smtplib.smtp(smtp_server, smtp_port)
server.starttls()
# 剩下的代码和前面的一模一样:
server.set_debuglevel(1)
...

只需要在创建 smtp 对象后,立刻调用 starttls() 方法,就创建了安全连接。后面的代码和前面的发送邮件代码完全一样。

pop3收取邮件

python内置一个 poplib 模块,实现了pop3协议,可以直接用来收邮件。

注意到pop3协议收取的不是一个已经可以阅读的邮件本身,而是邮件的原始文本,这和smtp协议很像,smtp发送的也是经过编码后的一大段文本。

要把pop3收取的文本变成可以阅读的邮件,还需要用email模块提供的各种类来解析原始文本,变成可阅读的邮件对象。

所以,收取邮件分两步:

第一步:用 poplib 把邮件的原始文本下载到本地;

第二部:用 email 解析原始文本,还原为邮件对象。

通过pop3下载邮件

pop3协议本身很简单,以下面的代码为例,我们来获取最新的一封邮件内容:

from email.parser import parser
import poplib

# 输入邮件地址, 口令和pop3服务器地址:
email = 'pangao1990@qq.com'
password = 'password'
pop3_server = 'pop.qq.com'

# 连接到pop3服务器:
server = poplib.pop3_ssl(pop3_server)
# 可以打开或关闭调试信息:
server.set_debuglevel(1)

# 身份认证:
server.user(email)
server.pass_(password)

# list()返回所有邮件的编号:
resp, mails, octets = server.list()

# 获取最新一封邮件, 注意索引号从1开始:
index = len(mails)
resp, lines, octets = server.retr(index)

# lines存储了邮件的原始文本的每一行,
# 可以获得整个邮件的原始文本:
msg_content = b'\r\n'.join(lines).decode('utf-8')
# 稍后解析出邮件:
msg = parser().parsestr(msg_content)

# 可以根据邮件索引号直接从服务器删除邮件:
# server.dele(index)
# 关闭连接:
server.quit()

但是这个 message 对象本身可能是一个 mimemultipart 对象,即包含嵌套的其他 mimebase 对象,嵌套可能还不止一层。

所以我们要递归地打印出 message 对象的层次结构:

from email.header import decode_header
from email.utils import parseaddr


def print_info(msg, indent=0):
 if indent == 0:
  for header in ['from', 'to', 'subject']:
   value = msg.get(header, '')
   if value:
    if header == 'subject':
     value = decode_str(value)
    else:
     hdr, addr = parseaddr(value)
     name = decode_str(hdr)
     value = u'%s <%s>' % (name, addr)
   print('%s%s: %s' % (' ' * indent, header, value))
 if (msg.is_multipart()):
  parts = msg.get_payload()
  for n, part in enumerate(parts):
   print('%spart %s' % (' ' * indent, n))
   print('%s--------------------' % (' ' * indent))
   print_info(part, indent + 1)
 else:
  content_type = msg.get_content_type()
  if content_type == 'text/plain' or content_type == 'text/html':
   content = msg.get_payload(decode=true)
   charset = guess_charset(msg)
   if charset:
    content = content.decode(charset)
   print('%stext: %s' % (' ' * indent, content + '...'))
  else:
   print('%sattachment: %s' % (' ' * indent, content_type))


def decode_str(s):
 value, charset = decode_header(s)[0]
 if charset:
  value = value.decode(charset)
 return value


def guess_charset(msg):
 charset = msg.get_charset()
 if charset is none:
  content_type = msg.get('content-type', '').lower()
  pos = content_type.find('charset=')
  if pos >= 0:
   charset = content_type[pos + 8:].strip()
 return charset


print_info(msg) #解析

# from: 木叶 <pangao1990@qq.com>
# to: <mail@pangao.vip>
# subject: 测试主题
# text: 测试内容
# 
# ...

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。