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

详细讲解用Python发送SMTP邮件的教程

程序员文章站 2022-12-14 19:57:31
smtp是发送邮件的协议,python内置对smtp的支持,可以发送纯文本邮件、html邮件以及带附件的邮件。 python对smtp支持有smtplib和email两个...

smtp是发送邮件的协议,python内置对smtp的支持,可以发送纯文本邮件、html邮件以及带附件的邮件。

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编码保证多语言兼容性。

然后,通过smtp发出去:

# 输入email地址和口令:
from_addr = raw_input('from: ')
password = raw_input('password: ')
# 输入smtp服务器地址:
smtp_server = raw_input('smtp server: ')
# 输入收件人地址:
to_addr = raw_input('to: ')

import smtplib
server = smtplib.smtp(smtp_server, 25) # smtp协议默认端口是25
server.set_debuglevel(1)
server.login(from_addr, password)
server.sendmail(from_addr, [to_addr], msg.as_string())
server.quit()

我们用set_debuglevel(1)就可以打印出和smtp服务器交互的所有信息。smtp协议就是简单的文本命令和响应。login()方法用来登录smtp服务器,sendmail()方法就是发邮件,由于可以一次发给多个人,所以传入一个list,邮件正文是一个str,as_string()把mimetext对象变成str。

如果一切顺利,就可以在收件人信箱中收到我们刚发送的email:

详细讲解用Python发送SMTP邮件的教程

仔细观察,发现如下问题:

  •     邮件没有主题;
  •     收件人的名字没有显示为友好的名字,比如mr green <green@example.com>;
  •     明明收到了邮件,却提示不在收件人中。

这是因为邮件主题、如何显示发件人、收件人等信息并不是通过smtp协议发给mta,而是包含在发给mta的文本中的,所以,我们必须把from、to和subject添加到mimetext中,才是一封完整的邮件:

# -*- coding: utf-8 -*-

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.encode('utf-8') if isinstance(addr, unicode) else addr))

from_addr = raw_input('from: ')
password = raw_input('password: ')
to_addr = raw_input('to: ')
smtp_server = raw_input('smtp server: ')

msg = mimetext('hello, send by python...', 'plain', 'utf-8')
msg['from'] = _format_addr(u'python爱好者 <%s>' % from_addr)
msg['to'] = _format_addr(u'管理员 <%s>' % to_addr)
msg['subject'] = header(u'来自smtp的问候……', '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()

我们编写了一个函数_format_addr()来格式化一个邮件地址。注意不能简单地传入name <addr@example.com>,因为如果包含中文,需要通过header对象进行编码。

msg['to']接收的是字符串而不是list,如果有多个邮件地址,用,分隔即可。

再发送一遍邮件,就可以在收件人邮箱中看到正确的标题、发件人和收件人:

详细讲解用Python发送SMTP邮件的教程

你看到的收件人的名字很可能不是我们传入的管理员,因为很多邮件服务商在显示邮件时,会把收件人名字自动替换为用户注册的名字,但是其他收件人名字的显示不受影响。

如果我们查看email的原始内容,可以看到如下经过编码的邮件头:

from: =?utf-8?b?uhl0ag9u54ix5aw96icf?= <xxxxxx@163.com>
to: =?utf-8?b?566h55cg5zgy?= <xxxxxx@qq.com>
subject: =?utf-8?b?5p2l6iequ01uuoeahomxruwamekapukapg==?=

这就是经过header对象编码的文本,包含utf-8编码信息和base64编码的文本。如果我们自己来手动构造这样的编码文本,显然比较复杂。
发送html邮件

如果我们要发送html邮件,而不是普通的纯文本文件怎么办?方法很简单,在构造mimetext对象时,把html字符串传进去,再把第二个参数由plain变为html就可以了:

msg = mimetext('<html><body><h1>hello</h1>' +
  '<p>send by <a href="http://www.python.org">python</a>...</p>' +
  '</body></html>', 'html', 'utf-8')

再发送一遍邮件,你将看到以html显示的邮件:

详细讲解用Python发送SMTP邮件的教程

发送附件

如果email中要加上附件怎么办?带附件的邮件可以看做包含若*分的邮件:文本和各个附件本身,所以,可以构造一个mimemultipart对象代表邮件本身,然后往里面加上一个mimetext作为邮件正文,再继续往里面加上表示附件的mimebase对象即可:

# 邮件对象:
msg = mimemultipart()
msg['from'] = _format_addr(u'python爱好者 <%s>' % from_addr)
msg['to'] = _format_addr(u'管理员 <%s>' % to_addr)
msg['subject'] = header(u'来自smtp的问候……', 'utf-8').encode()

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

# 添加附件就是加上一个mimebase,从本地读取一个图片:
with open('/users/michael/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)

然后,按正常发送流程把msg(注意类型已变为mimemultipart)发送出去,就可以收到如下带附件的邮件:

详细讲解用Python发送SMTP邮件的教程

发送图片

如果要把一个图片嵌入到邮件正文中怎么做?直接在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'))

再次发送,就可以看到图片直接嵌入到邮件正文的效果:

详细讲解用Python发送SMTP邮件的教程

同时支持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()方法,就创建了安全连接。后面的代码和前面的发送邮件代码完全一样。

如果因为网络问题无法连接gmail的smtp服务器,请相信我们的代码是没有问题的,你需要对你的网络设置做必要的调整。
小结

使用python的smtplib发送邮件十分简单,只要掌握了各种邮件类型的构造方法,正确设置好邮件头,就可以顺利发出。

构造一个邮件对象就是一个messag对象,如果构造一个mimetext对象,就表示一个文本邮件对象,如果构造一个mimeimage对象,就表示一个作为附件的图片,要把多个对象组合起来,就用mimemultipart对象,而mimebase可以表示任何对象。它们的继承关系如下:

复制代码 代码如下:
message
+- mimebase
   +- mimemultipart
   +- mimenonmultipart
      +- mimemessage
      +- mimetext
      +- mimeimage

这种嵌套关系就可以构造出任意复杂的邮件。你可以通过email.mime文档查看它们所在的包以及详细的用法。

源码参考:

https://github.com/michaelliao/learn-python/tree/master/email