SMTP(Simple Mail Transfer Protocol)即简单邮件传输协议,它是一组用于由源地址到目的地址传送邮件的规则,由它来控制信件的中转方式。
python的smtplib提供了一种很方便的途径发送电子邮件。它对smtp协议进行了简单的封装。
Python创建 SMTP 对象语法如下:
import smtplib
smtpObj = smtplib.SMTP( [host [, port [, local_hostname]]] )
参数说明:
- host: SMTP 服务器主机。 你可以指定主机的ip地址或者域名如: runoob.com,这个是可选参数。
- port: 如果你提供了 host 参数, 你需要指定 SMTP 服务使用的端口号,一般情况下 SMTP 端口号为25。
- local_hostname: 如果 SMTP 在你的本机上,你只需要指定服务器地址为 localhost 即可。
Python SMTP 对象使用 sendmail 方法发送邮件,语法如下:
SMTP.sendmail(from_addr, to_addrs, msg[, mail_options, rcpt_options]
参数说明:
- from_addr: 邮件发送者地址。
- to_addrs: 字符串列表,邮件发送地址。
- msg: 发送消息
这里要注意一下第三个参数,msg 是字符串,表示邮件。我们知道邮件一般由标题,发信人,收件人,邮件内容,附件等构成,发送邮件的时候,要注意 msg 的格式。这个格式就是 smtp 协议中定义的格式。
实例
以下执行实例需要你本机已安装了支持 SMTP 的服务,如:sendmail。
以下是一个使用 Python 发送邮件简单的实例:
实例
1 #!/usr/bin/python 2 # -*- coding: UTF-8 -*- 3 4 import smtplib 5 from email.mime.text import MIMEText 6 from email.header import Header 7 8 sender = 'from@runoob.com' 9 receivers = ['429240967@qq.com'] # 接收邮件,可设置为你的QQ邮箱或者其他邮箱 10 11 # 三个参数:第一个为文本内容,第二个 plain 设置文本格式,第三个 utf-8 设置编码 12 message = MIMEText('Python 邮件发送测试...', 'plain', 'utf-8') 13 message['From'] = Header("菜鸟教程", 'utf-8') 14 message['To'] = Header("测试", 'utf-8') 15 16 subject = 'Python SMTP 邮件测试' 17 message['Subject'] = Header(subject, 'utf-8') 18 19 20 try: 21 smtpObj = smtplib.SMTP('localhost') 22 smtpObj.sendmail(sender, receivers, message.as_string()) 23 print "邮件发送成功" 24 except smtplib.SMTPException: 25 print "Error: 无法发送邮件"
我们通过实例化 smtplib 模块的 SMTP 对象 smtpObj 来连接到 SMTP 访问,并使用 sendmail 方法来发送信息。
执行以上程序,如果你本机安装 sendmail(邮件传输代理程序),就会输出:
$ python test.py
邮件发送成功
查看我们的收件箱(一般在垃圾箱),就可以查看到邮件信息:
如果我们本机没有 sendmail 访问,也可以使用其他邮件服务商的 SMTP 访问(QQ、网易、Google等)。
实例
1 #!/usr/bin/python 2 # -*- coding: UTF-8 -*- 3 4 import smtplib 5 from email.mime.text import MIMEText 6 from email.header import Header 7 8 # 第三方 SMTP 服务 9 mail_host="smtp.XXX.com" #设置服务器 10 mail_user="XXXX" #用户名 11 mail_pass="XXXXXX" #口令 12 13 14 sender = 'from@runoob.com' 15 receivers = ['429240967@qq.com'] # 接收邮件,可设置为你的QQ邮箱或者其他邮箱 16 17 message = MIMEText('Python 邮件发送测试...', 'plain', 'utf-8') 18 message['From'] = Header("菜鸟教程", 'utf-8') 19 message['To'] = Header("测试", 'utf-8') 20 21 subject = 'Python SMTP 邮件测试' 22 message['Subject'] = Header(subject, 'utf-8') 23 24 25 try: 26 smtpObj = smtplib.SMTP() 27 smtpObj.connect(mail_host, 25) # 25 为 SMTP 端口号 28 smtpObj.login(mail_user,mail_pass) 29 smtpObj.sendmail(sender, receivers, message.as_string()) 30 print "邮件发送成功" 31 except smtplib.SMTPException: 32 print "Error: 无法发送邮件"
使用Python发送HTML格式的邮件
Python发送HTML格式的邮件与发送纯文本消息的邮件不同之处就是将MIMEText中_subtype设置为html。具体代码如下:
实例
1 #!/usr/bin/python 2 # -*- coding: UTF-8 -*- 3 4 import smtplib 5 from email.mime.text import MIMEText 6 from email.header import Header 7 8 sender = 'from@runoob.com' 9 receivers = ['429240967@qq.com'] # 接收邮件,可设置为你的QQ邮箱或者其他邮箱 10 11 mail_msg = """ 12 <p>Python 邮件发送测试...</p> 13 <p><a href="http://www.runoob.com">这是一个链接</a></p> 14 """ 15 message = MIMEText(mail_msg, 'html', 'utf-8') 16 message['From'] = Header("菜鸟教程", 'utf-8') 17 message['To'] = Header("测试", 'utf-8') 18 19 subject = 'Python SMTP 邮件测试' 20 message['Subject'] = Header(subject, 'utf-8') 21 22 23 try: 24 smtpObj = smtplib.SMTP('localhost') 25 smtpObj.sendmail(sender, receivers, message.as_string()) 26 print "邮件发送成功" 27 except smtplib.SMTPException: 28 print "Error: 无法发送邮件"
执行以上程序,如果你本机安装sendmail,就会输出:
$ python test.py
邮件发送成功
查看我们的收件箱(一般在垃圾箱),就可以查看到邮件信息:
Python 发送带附件的邮件
发送带附件的邮件,首先要创建MIMEMultipart()实例,然后构造附件,如果有多个附件,可依次构造,最后利用smtplib.smtp发送。
实例
1 #!/usr/bin/python 2 # -*- coding: UTF-8 -*- 3 4 import smtplib 5 from email.mime.text import MIMEText 6 from email.mime.multipart import MIMEMultipart 7 from email.header import Header 8 9 sender = 'from@runoob.com' 10 receivers = ['429240967@qq.com'] # 接收邮件,可设置为你的QQ邮箱或者其他邮箱 11 12 #创建一个带附件的实例 13 message = MIMEMultipart() 14 message['From'] = Header("菜鸟教程", 'utf-8') 15 message['To'] = Header("测试", 'utf-8') 16 subject = 'Python SMTP 邮件测试' 17 message['Subject'] = Header(subject, 'utf-8') 18 19 #邮件正文内容 20 message.attach(MIMEText('这是菜鸟教程Python 邮件发送测试……', 'plain', 'utf-8')) 21 22 # 构造附件1,传送当前目录下的 test.txt 文件 23 att1 = MIMEText(open('test.txt', 'rb').read(), 'base64', 'utf-8') 24 att1["Content-Type"] = 'application/octet-stream' 25 # 这里的filename可以任意写,写什么名字,邮件中显示什么名字 26 att1["Content-Disposition"] = 'attachment; filename="test.txt"' 27 message.attach(att1) 28 29 # 构造附件2,传送当前目录下的 runoob.txt 文件 30 att2 = MIMEText(open('runoob.txt', 'rb').read(), 'base64', 'utf-8') 31 att2["Content-Type"] = 'application/octet-stream' 32 att2["Content-Disposition"] = 'attachment; filename="runoob.txt"' 33 message.attach(att2) 34 35 try: 36 smtpObj = smtplib.SMTP('localhost') 37 smtpObj.sendmail(sender, receivers, message.as_string()) 38 print "邮件发送成功" 39 except smtplib.SMTPException: 40 print "Error: 无法发送邮件"
$ python test.py
邮件发送成功
查看我们的收件箱(一般在垃圾箱),就可以查看到邮件信息:
在 HTML 文本中添加图片
邮件的 HTML 文本中一般邮件服务商添加外链是无效的,正确添加突破的实例如下所示:
实例
1 #!/usr/bin/python 2 # -*- coding: UTF-8 -*- 3 4 import smtplib 5 from email.mime.image import MIMEImage 6 from email.mime.multipart import MIMEMultipart 7 from email.mime.text import MIMEText 8 from email.header import Header 9 10 sender = 'from@runoob.com' 11 receivers = ['429240967@qq.com'] # 接收邮件,可设置为你的QQ邮箱或者其他邮箱 12 13 msgRoot = MIMEMultipart('related') 14 msgRoot['From'] = Header("菜鸟教程", 'utf-8') 15 msgRoot['To'] = Header("测试", 'utf-8') 16 subject = 'Python SMTP 邮件测试' 17 msgRoot['Subject'] = Header(subject, 'utf-8') 18 19 msgAlternative = MIMEMultipart('alternative') 20 msgRoot.attach(msgAlternative) 21 22 23 mail_msg = """ 24 <p>Python 邮件发送测试...</p> 25 <p><a href="http://www.runoob.com">菜鸟教程链接</a></p> 26 <p>图片演示:</p> 27 <p><img src="cid:image1"></p> 28 """ 29 msgAlternative.attach(MIMEText(mail_msg, 'html', 'utf-8')) 30 31 # 指定图片为当前目录 32 fp = open('test.png', 'rb') 33 msgImage = MIMEImage(fp.read()) 34 fp.close() 35 36 # 定义图片 ID,在 HTML 文本中引用 37 msgImage.add_header('Content-ID', '<image1>') 38 msgRoot.attach(msgImage) 39 40 try: 41 smtpObj = smtplib.SMTP('localhost') 42 smtpObj.sendmail(sender, receivers, msgRoot.as_string()) 43 print "邮件发送成功" 44 except smtplib.SMTPException: 45 print "Error: 无法发送邮件"
$ python test.py
邮件发送成功
查看我们的收件箱(如果在垃圾箱可能需要移动到收件箱才可正常显示),就可以查看到邮件信息:
使用第三方 SMTP 服务发送
这里使用了 QQ 邮箱(你也可以使用 163,Gmail等)的 SMTP 服务,需要做以下配置:
QQ 邮箱通过生成授权码来设置密码:
QQ 邮箱 SMTP 服务器地址:smtp.qq.com,ssl 端口:465。
以下实例你需要修改:发件人邮箱(你的QQ邮箱),密码,收件人邮箱(可发给自己)。
QQ SMTP
1 #!/usr/bin/python 2 # -*- coding: UTF-8 -*- 3 4 import smtplib 5 from email.mime.text import MIMEText 6 from email.utils import formataddr 7 8 my_sender='429240967@qq.com' # 发件人邮箱账号 9 my_pass = 'xxxxxxxxxx' # 设置的授权码 10 my_user='429240967@qq.com' # 收件人邮箱账号,我这边发送给自己 11 def mail(): 12 ret=True 13 try: 14 msg=MIMEText('填写邮件内容','plain','utf-8') 15 msg['From']=formataddr(["FromRunoob",my_sender]) # 括号里的对应发件人邮箱昵称、发件人邮箱账号 16 msg['To']=formataddr(["FK",my_user]) # 括号里的对应收件人邮箱昵称、收件人邮箱账号 17 msg['Subject']="菜鸟教程发送邮件测试" # 邮件的主题,也可以说是标题 18 19 server=smtplib.SMTP_SSL("smtp.qq.com", 465) # 发件人邮箱中的SMTP服务器,端口是25 20 server.login(my_sender, my_pass) # 括号中对应的是发件人邮箱账号、邮箱密码 21 server.sendmail(my_sender,[my_user,],msg.as_string()) # 括号中对应的是发件人邮箱账号、收件人邮箱账号、发送邮件 22 server.quit() # 关闭连接 23 except Exception: # 如果 try 中的语句没有执行,则会执行下面的 ret=False 24 ret=False 25 return ret 26 27 ret=mail() 28 if ret: 29 print("邮件发送成功") 30 else: 31 print("邮件发送失败")
$ python test.py
邮件发送成功
发送成功后,登陆收件人邮箱即可查看: