先来了解一下收/发邮件有哪些协议:
- 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支持有 smtplib 和 email 两个模块,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
from_addr =
'test_from_addr
@qq
.com'
password =
'Password'
to_addr =
'test_to_addr
@qq
.com'
smtp_server = smtp.qq.com 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()
sendmail() 方法就是发邮件,由于可以一次发给多个人,所以传入一个 list,邮件正文是一个 str,as_string() 把MIMEText对象变成 str。
注意: QQ邮件等需要手动开通 SMTP服务 , 邮箱设置 => 账号 => POP3/SMTP服务,如下图:
image
image
此时,我们就可以收到邮件了,如下:
image
添加邮件标题、收/发件人
邮件主题、显示发件人、收件人等信息并不是通过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()
收到的邮件,如下:
image
收件人并不是我们设置的 “收件人昵称”,是因为很多邮件服务商在显示邮件时,会把收件人名字自动替换为用户注册的名字,这无伤大雅。
添加抄送,暗送
# ccto_list 抄送
# bccto_list 暗送
msg[
'from'
] = user msg[
'to'
] =
','
.
join
(to_list)
#注意,不是分号
msg[
'cc'
] =
','
.
join
(ccto_list) msg[
'subject'
] = subject server.sendmail(sender,to_list+ccto_list+bccto_list, str(msg))
发送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()
msg.attach(MIMEText(
'send with file...'
,
'plain'
,
'utf-8'
))
with
open(
'/Users/pangao/Downloads/test.png'
,
'rb'
)
as
f:
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())
encoders.encode_base64(mime)
msg.attach(mime)
image
发送图片
由于 mac 自带的邮件会自动把图片附件插入邮件正文中,所以样式很好看。但是普通邮件可能没这么便捷(抱歉,我没见过普通邮件。。。小小嘚瑟一下)
如果要把一个图片嵌入到邮件正文中怎么做?直接在HTML邮件中链接图片地址行不行?答案是,大部分邮件服务商都会自动屏蔽带有外链的图片,因为不知道这些链接是否指向恶意网站。
要把图片嵌入到邮件正文中,我们只需按照发送附件的方式,先把邮件作为附件添加进去,然后,在HTML中通过引用 src=”cid:0″ 就可以把附件作为图片嵌入了。如果有多个图片,给它们依次编号,然后引用不同的 cid:x 即可。
把上面代码加入 MIMEMultipart 的 MIMEText 从 plain 改为 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(
'
Hello
',
'html'
,
'utf-8'
))
加密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
email
=
'pangao1990@qq.com'
password
=
'Password'
pop3_server
=
'pop.qq.com'
server
=
poplib.POP3_SSL(pop3_server)
server.set_debuglevel(1)
server.user(email)
server.pass_(password)
resp,
mails, octets = server.list()
index
=
len(mails)
resp,
lines, octets = server.retr(index)
msg_content
=
b'\r\n'.join(lines).decode('utf-8')
msg
=
Parser().parsestr(msg_content)
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)