Python smtplib模块详解:发送邮件

< 上一页UDP多点广播 Python poplib下一页 >

使用 Python 的 smtplib 模块来发送邮件非常简单,大部分底层的处理都由 smtplib 进行了封装,开发者只需要按照如下 3 步来发送邮件即可:
  1. 连接 SMTP 服务器,并使用用户名、密码登录服务器。
  2. 创建 EmailMessage 对象,该对象代表邮件本身。
  3. 调用代表与 SMTP 服务器连接的对象的 sendmail() 方法发送邮件。

下面程序按照上面步骤示范了如何发送邮件:
import smtplib
from email.message import EmailMessage

# 定义SMTP服务器地址:
smtp_server = 'smtp.qq.com'
# 定义发件人地址
from_addr = 'kongyeeku@qq.com'
# 定义登录邮箱的密码
password = '123456'
# 定义收件人地址:
to_addr = 'kongyeeku@163.com'

# 创建SMTP连接
#conn = smtplib.SMTP(smtp_server, 25)
conn = smtplib.SMTP_SSL(smtp_server,465)
conn.set_debuglevel(1)
conn.login(from_addr, password)            #①
# 创建邮件对象
msg = EmailMessage()
# 设置邮件内容
msg.set_content('您好,这是一封来自Python的邮件', 'plain', 'utf-8')
# 发送邮件
conn.sendmail(from_addr, [to_addr], msg.as_string())
# 退出连接
conn.quit()
上面程序中,第 15 行、19 行和 23 行代码基本代表了使用 Python 的 smtp 模块发送邮件的 3 大核心步骤,其中 ① 号代码使用了发件人的地址和密码来登录邮箱。

关于该程序有以下几点需要说明:
  • 程序中提供的邮箱密码是错误的,不用尝试。读者必须改为使用自己的邮箱地址和密码。
  • 早期SMTP 服务器都采用普通的网络连接,因此默认端口是 25。但现在绝大部分 SMTP 都是基于 SSL(Secure Socket Layer)的,这样保证网络上传输的信息都是加密过的,从而使得信息更加安全。这种基于 SSL 的 SMTP 服务器的默认端口是 465。上面程序中连接的是 QQ 邮箱的基于 SSL 的 SMTP 服务器,QQ 邮箱服务器不支持普通的 SMTP。
  • 国内有些公司的免费邮箱(比如 QQ 邮箱)默认是关闭了 SMTP 的,因此需要读者登录邮箱进行设置。
  • 由于该程序发送的邮件太简单,邮件没有主题,而且程序在测试过程中可能会发送很多邮件,因此有些邮箱服务商会将该程序发送的邮件当成垃圾邮件。

早期 Python 2.x 提供了 email.mime、email.header、email.charset、email.encoders、email.iterators 等库来处理邮件,这些库设计得过于烦琐,用起来极为不便,因此读者应该尽快改为使用最新的 Python 库。本教程不会介绍这些过时的库。具体可参考 https://docs.python.org/3/library/email.html 页面的说明。

由于程序打开了 smtplib 调试模式(将 debuglevel 设置为 1),因此在运行该程序时,可以看到 SMTP 发送邮件的详细过程。当程序运行结束后,将可以在收件人邮箱中看到一封新邮件(可能在垃圾邮件内),如图 1 所示。

在收件人邮箱内收到了 smtplib 模块发送的邮件
图 1 在收件人邮箱内收到了 smtplib 模块发送的邮件

上面这封邮件是最简单的,没有为该邮件设置主题、发件人名字和收件人名字,邮件内容也只是简单的文本。如果要为邮件设置主题、发件人名字和收件人名字,那么只需设置 EmailMessage 对象的相应属性即可。如果程序要将邮件内容改为 HTML 内容,那么只需将调用 EmailMessage的set_content() 方法的第二个参数设置为 html 即可。

例如,如下程序只是对 EmailMessage 进行了修改:
import smtplib
from email.message import EmailMessage

# 定义SMTP服务器地址:
smtp_server = 'smtp.qq.com'
# 定义发件人地址
from_addr = 'kongyeeku@qq.com'
# 定义登录邮箱的密码
password = '123456'
# 定义收件人地址:
to_addr = 'kongyeeku@163.com'

# 创建SMTP连接
#conn = smtplib.SMTP(smtp_server, 25)
conn = smtplib.SMTP_SSL(smtp_server,465)
conn.set_debuglevel(1)
conn.login(from_addr, password)            #①
# 创建邮件对象
msg = EmailMessage()
# 设置邮件内容,指定邮件内容为HTML
msg.set_content('<h2>邮件内容</h2>' +
    '<p>您好,这是一封来自Python的邮件<p>' +
    '来自<a href="http://c.biancheng.net">C语言中文网</a>', 'html', 'utf-8')
msg['subject'] = '一封HTML邮件'
msg['from'] = '李刚 <%s>' % from_addr
msg['to'] = '新用户 <%s>' % to_addr
# 发送邮件
conn.sendmail(from_addr, [to_addr], msg.as_string())
# 退出连接
conn.quit()
该程序与上一个程序基本相似,只是在调用 set_content() 方法时将第二个参数改为了“html”。

此外,程序增加了上面 3 行代码(第 24~26 行),分别用于设置邮件主题、发件人名字和收件人名字。运行上面程序,在目标邮箱内可以看到如图 2 所示的邮件。

设置了邮件主题、发件人名字和收件人名字的 HTML 邮件
图 2 设置了邮件主题、发件人名字和收件人名字的 HTML 邮件

打开该邮件,将可以看到如图 3 所示的邮件内容。

HTML 邮件内容
图 3 HTML 邮件内容

如果希望实现图文并茂的邮件,也就是在邮件中插入图片,则首先要给邮件添加附件(不要直接在邮件中嵌入外链的图片,很多邮箱出于安全考虑,都会禁用邮件中外链的资源)。因此,如果直接在 HTML 右键中外链其他图片,那么该图片很有可能显示不出来。

为了给邮件添加附件,只需调用 EmailMessage的add_attachment() 方法即可。该方法支持很多参数,最常见的参数如下:
  • maintype:指定附件的主类型。比如指定 image 代表附件是图片。
  • subtype:指定附件的子类型。比如指定为 png,代表附件是 PNG 图片。一般来说,子类型受主类型的限制。
  • filename:指定附件的文件名。
  • cid=img:指定附件的资源 ID,邮件正文可通过资源 ID 来引用该资源。

例如,如下程序为邮件添加了 3 个附件:
import smtplib, email.utils
from email.message import EmailMessage

# 定义SMTP服务器地址:
smtp_server = 'smtp.qq.com'
# 定义发件人地址
from_addr = 'kongyeeku@qq.com'
# 定义登录邮箱的密码
password = '123456'
# 定义收件人地址:
to_addr = 'kongyeeku@163.com'

# 创建SMTP连接
#conn = smtplib.SMTP(smtp_server, 25)
conn = smtplib.SMTP_SSL(smtp_server,465)
conn.set_debuglevel(1)
conn.login(from_addr, password)            #①
# 创建邮件对象
msg = EmailMessage()
# 随机生成两个图片id
first_id, second_id = email.utils.make_msgid(), email.utils.make_msgid()
# 设置邮件内容,指定邮件内容为HTML
msg.set_content('<h2>邮件内容</h2>' +
    '<p>您好,这是一封来自Python的邮件' +
    '<img src="cid:' + second_id[1:-1] +'"><p>' +
    '来自<a href="http://c.biancheng.net">C语言中文网</a>')
msg['subject'] = '一封HTML邮件'
msg['from'] = '李刚 <%s>' % from_addr
msg['to'] = '新用户 <%s>' % to_addr
with open('E:/logo.jpg', 'rb') as f:
    # 添加第一个附件
    msg.add_attachment(f.read(), maintype='image',
        subtype='jpeg', filename='test.png', cid=first_id)
with open('E:/fklogo.gif', 'rb') as f:
    # 添加第二个附件
    msg.add_attachment(f.read(), maintype='image',
        subtype='gif', filename='test.gif', cid=second_id)
with open('E:/fkit.pdf', 'rb') as f:
    # 添加第三个附件,邮件正文不需引用该附件,因此不指定cid
    msg.add_attachment(f.read(), maintype='application',
        subtype='pdf', filename='test.pdf',)
# 发送邮件
conn.sendmail(from_addr, [to_addr], msg.as_string())
# 退出连接
conn.quit()
该程序与上一个程序的最大区别在于增加了一段代码(31 行代码起),它们为邮件添加了三个附件。

由于邮件正文不需要引用第三个附件,因此程序添加第三个附件时没有指定 cid 属性。

在添加附件时指定 cid 属性之后,程序就可以在邮件正文中通过该 cid 来引用附件,如上面程序中邮件正文代码所示。运行上面程序,可以在目标邮箱内看到一封新邮件。打开该邮件,可看到邮件内容。

通过上面三个示例,可以发现使用 smtplib 模块发送邮件很简单,基本只需要连接服务器、创建邮件和发送邮件三个步骤。如果要构建复杂的邮件内容,则主要通过 EmailMessage 对象来进行设置。EmailMessage 也是 Python 3.x 对邮件处理的巨大简化,它把对邮件内容的各种处理都封装在 EmailMessage 类中,因此使得编程变得轻松、简单。
< 上一页UDP多点广播 Python poplib下一页 >