Python SMTP发送邮件
一、介绍
SMTP(Simple Mail Transfer Protocol)即简单邮件传输协议,它是一组用于由源地址到目的地址传送邮件的规则,由它来控制信件的中转方式。
python的smtplib提供了一种很方便的途径发送电子邮件。它对smtp协议进行了简单的封装。
Python内置对SMTP的支持,可以发送纯文本邮件、HTML邮件以及带附件的邮件。
Python对SMTP支持有smtplib和email两个模块,email负责构造邮件,smtplib负责发送邮件
二、基础语法
1、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 即可。
或者:
import smtplib smtpObj = smtplib.SMTP() smtpObj.connect(host, 25) # 25 为 SMTP 端口号 smtpObj.quit()
2、Python SMTP 对象使用 sendmail 方法发送邮件
语法如下:
smtpObj.sendmail(from_addr, to_addrs, msg[, mail_options, rcpt_options])
参数说明:
- from_addr: 邮件发送者地址(即你的邮箱地址)。
- to_addrs: 字符串列表,邮件发送地址(发给谁,即对方邮箱地址)。
- msg: 发送消息
这里要注意一下第三个参数,msg 是字符串,表示邮件。我们知道邮件一般由标题,发信人,收件人,邮件内容,附件等构成,发送邮件的时候,要注意 msg 的格式。这个格式就是 smtp 协议中定义的格式。
三、纯文本邮件示例
1、基础语法
""" 如果本机已经安装了支持SMTP服务,如sendemail, 我们使用三个引号来设置邮件信息,标准邮件需要三个头部信息: From, To, 和 Subject ,每个信息直接使用空行分割。 msg['To']接收的是字符串而不是list,如果有多个邮件地址,用,分隔即可。 我们通过实例化 smtplib 模块的 SMTP 对象 smtpObj 来连接到 SMTP 访问,并使用 sendmail 方法来发送信息。 执行以上程序,如果你本机安装 sendmail(邮件传输代理程序) """ import smtplib from email.mime.text import MIMEText from email.header import Header sender = 'xxx' # 发送者的邮箱 receivers = ['xxx@qq.com'] # 接收邮件,其他人的邮箱 # 三个参数:第一个为文本内容,第二个为格式 plain 代表文本格式,第三个 utf-8 设置编码 message = MIMEText('邮件发送测试', 'plain', 'utf-8') # 邮箱内容 message['From'] = Header("ZBJ", 'utf-8') # 发送者 message['To'] = Header("测试", 'utf-8') # 接收者 subject = 'Python SMTP 邮件测试' message['Subject'] = Header(subject, 'utf-8') # 邮箱主题 try: smtpObj = smtplib.SMTP('localhost') smtpObj.sendmail(sender, receivers, message.as_string()) print("邮件发送成功") except smtplib.SMTPException: print("Error: 无法发送邮件") """ 如果我们本机没有 sendmail 访问,也可以使用其他邮件服务商的 SMTP 访问(QQ、网易、Google等) """ import smtplib from email.mime.text import MIMEText from email.header import Header # 第三方 SMTP 服务 mail_host="smtp.XXX.com" # 设置服务器 mail_user="XXXX" # 用户名 mail_pass="XXXXXX" # 口令 sender = 'xxx' # 发送者邮箱 receivers = ['xxx@qq.com'] # 接收邮件,其他人的邮箱 message = MIMEText('邮件发送测.', 'plain', 'utf-8') message['From'] = Header("ZBJ", 'utf-8') message['To'] = Header("测试", 'utf-8') subject = 'Python SMTP 邮件测试' message['Subject'] = Header(subject, 'utf-8') try: smtpObj = smtplib.SMTP() smtpObj.connect(mail_host, 25) # 端口根据服务器不同可能会改变 smtpObj.login(mail_user,mail_pass) smtpObj.sendmail(sender, receivers, message.as_string()) print("邮件发送成功") except smtplib.SMTPException: print("Error: 无法发送邮件")
2、纯文本邮件示例(QQ邮箱)
QQ邮箱 POP3 和 SMTP 服务器地址设置如下:
邮箱 | POP3服务器(端口995) | SMTP服务器(端口465或587) |
---|---|---|
qq.com | pop.qq.com | smtp.qq.com |
SMTP服务器需要身份验证。根据提示开启相关服务,选择生成授权码,得到后用于后续代码登陆部分
首先必须要打开QQ邮箱的smtp服务,在QQ邮箱个人主页的 设置-账户 中开启。如图:
成功开启后点击生成授权码 ,得到的密码为smtp发送邮件时的登录密码。
import smtplib from email.mime.text import MIMEText from email.header import Header # 第三方 SMTP 服务 mail_host="smtp.qq.com" # 设置服务器 mail_user="xxx@qq.com" # 用户名(你的邮箱) mail_pass="yxdfsdwssdftsdg" # 口令,即开启smtp服务得到的授权码,不是QQ密码 sender = "xxx@qq.com" # 发送者的邮箱(也是你的邮箱,同用户名) receivers = ["yyy@qq.com"] # 接收邮件,其他人邮箱 # 三个参数:第一个为文本内容,第二个为格式 plain 代表文本格式,第三个 utf-8 设置编码 message = MIMEText("smtplib测试", "plain", "utf-8") # 标准邮件需要三个头部信息: From, To, 和 Subject message["From"] = Header("ZBJ", "utf-8") # 发送人(名称) message["To"] = Header("测试", "utf-8") # 接收人(名称) subject = 'Python SMTP 邮件测试' message['Subject'] = Header(subject, 'utf-8') # 邮件主题 try: smtpObj = smtplib.SMTP() smtpObj.connect(mail_host, 25) # 25 为 SMTP 端口号 """ 但是这样我们用25号端口都是以明文发送的,很容易被监视, 所以我们可以发送加密邮件,只需要利用SSL: smtpObj = smtplib.SMTP_SSL() smtpObj.connect(mail_host, 465) # QQ邮箱的端口465或587 SMTP和SMTP_SSL选择一个使用即可 """ smtpObj.login(mail_user, mail_pass) smtpObj.sendmail(sender, receivers, message.as_string()) print("邮件发送成功") smtpObj.quit() except smtplib.SMTPException: print("Error: 无法发送邮件")
结果如下:
3、使用 formataddr 生成真实的发送/接收者
formataddr 和 parseaddr 用法介绍
from email.utils import parseaddr from email.utils import formataddr # 根据 <> 进行分割,分割出用户名和邮箱 me = "ZBJ <xxx@qq.com>" ret = parseaddr(me) # 入参是字符串 print(ret) # ('ZBJ', 'xxx@qq.com') # 跟parseaddr相反,把某个列表合并成邮箱格式 f_str = formataddr(["ZBJ", "xxx@qq.com"]) # 入参是列表或者元组 print(f_str) # ZBJ <xxx@qq.com>
上面代码设置标准邮件的三个头部信息时,使用的时Header,
Header是自定义的头部信息,不是真实的,
而使用formataddr则是设置真实的信息。
import smtplib from email.mime.text import MIMEText from email.header import Header from email.utils import formataddr # 第三方 SMTP 服务 mail_host="smtp.qq.com" # 设置服务器 mail_user="xxx@qq.com" # 用户名 mail_pass="uhadlxasddwsdgq" # 口令 sender = "xxx@qq.com" # 发送者的邮箱 receivers = ["yyy@qq.com"] # 接收邮件,其他人的邮箱 message = MIMEText("嘿嘿嘿", "plain", "utf-8") # 标准邮件需要三个头部信息: From, To, 和 Subject message["From"] = formataddr(["ZBJ", sender]) # 列表里的对应发件人邮箱昵称、发件人邮箱账号 message["To"] = formataddr(["小明", receivers[0]]) # 列表里的对应收件人邮箱昵称、收件人邮箱账号 subject = '邮件测试' message['Subject'] = Header(subject, 'utf-8') # 邮件主题 try: smtpObj = smtplib.SMTP_SSL() smtpObj.connect(mail_host, 465) smtpObj.login(mail_user, mail_pass) smtpObj.sendmail(sender, receivers, message.as_string()) print("邮件发送成功") smtpObj.quit() except smtplib.SMTPException: print("Error: 无法发送邮件")
结果如下:
四、HTML格式的邮件示例
Python发送HTML格式的邮件与发送纯文本消息的邮件不同之处就是将MIMEText中_subtype设置为html
import smtplib from email.mime.text import MIMEText from email.header import Header # 第三方 SMTP 服务 mail_host="smtp.qq.com" # 设置服务器 mail_user="xxx@qq.com" # 用户名 mail_pass="ysdfndwfgasd" # 口令 sender = "xxx@qq.com" # 发送者的邮箱 receivers = ["yyy@qq.com"] # 接收邮件,其他人的邮箱 mail_msg = """ <p>HTML邮件测试</p> <table> <thead> <tr> <th>序号</th> <th>姓名</th> <th>爱好</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>小明</td> <td>打球</td> </tr> <tr> <td>2</td> <td>小红</td> <td>发豪</td> </tr> </tbody> </table> """ # 设置为html邮箱 message = MIMEText(mail_msg, "html", "utf-8") # 标准邮件需要三个头部信息: From, To, 和 Subject message["From"] = Header("ZBJ", "utf-8") # 发送人 message["To"] = Header("小明", "utf-8") # 接收人 subject = 'HTML邮件测试' message['Subject'] = Header(subject, 'utf-8') # 邮件主题 try: smtpObj = smtplib.SMTP_SSL() smtpObj.connect(mail_host, 465) smtpObj.login(mail_user, mail_pass) smtpObj.sendmail(sender, receivers, message.as_string()) print("邮件发送成功") smtpObj.quit() except smtplib.SMTPException: print("Error: 无法发送邮件")
结果如下:
五、带附件的邮件
带附件的邮件可以看做包含若干部分的邮件:文本和各个附件本身,所以,可以构造一个MIMEMultipart
对象代表邮件本身,然后往里面加上一个MIMEText
作为邮件正文,再继续往里面加上表示附件的MIMEText
对象即可
import smtplib from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart from email.header import Header from email.utils import formataddr # 第三方 SMTP 服务 mail_host = "smtp.qq.com" # 设置服务器 mail_user = "xxx@qq.com" # 用户名 mail_pass = "ytuasfdwsbsdftwe" # 口令 sender = "xxx@qq.com" # 发送者的邮箱 receivers = ["yyy@qq.com"] # 接收邮件,其他人的邮箱 # 创建一个带附件的实例 message = MIMEMultipart() message["From"] = formataddr(["ZBJ", sender]) # 发送人 message["To"] = formataddr(["小明", receivers[0]]) # 接收人 subject = '带附件的邮件测试' message['Subject'] = Header(subject, 'utf-8') # 邮件主题 # 邮件正文内容 message.attach(MIMEText('这是带附件的邮件发送测试', 'plain', 'utf-8')) # 构造附件1,传送当前目录下的 test.txt 文件 att1 = MIMEText(open('test.txt', 'rb').read(), 'base64', 'utf-8') att1["Content-Type"] = 'application/octet-stream' # 这里的filename可以任意写,写什么名字,邮件中显示什么名字 att1["Content-Disposition"] = 'attachment; filename="test.txt"' message.attach(att1) # 构造附件2,传送当前目录下的 mypicture.png 图片 att2 = MIMEText(open('mypicture.png', 'rb').read(), 'base64', 'utf-8') att2["Content-Type"] = 'application/octet-stream' att2["Content-Disposition"] = 'attachment; filename="mypicture.png"' message.attach(att2) try: smtpObj = smtplib.SMTP_SSL() smtpObj.connect(mail_host, 465) smtpObj.login(mail_user, mail_pass) smtpObj.sendmail(sender, receivers, message.as_string()) print("邮件发送成功") smtpObj.quit() except smtplib.SMTPException: print("Error: 无法发送邮件")
结果如下:
六、HTML 文本中添加图片
要把一个图片嵌入到邮件正文中,如果直接在HTML邮件中链接图片地址是不行的,大部分邮件服务商都会自动屏蔽带有外链的图片,因为不知道这些链接是否指向恶意网站。
要把图片嵌入到邮件正文中,我们只需按照发送附件的方式,先把邮件作为附件添加进去,然后,在HTML中通过引用src="cid:0"
就可以把附件作为图片嵌入了。如果有多个图片,给它们依次编号,然后引用不同的cid:x
即可。
import smtplib from email.mime.text import MIMEText from email.mime.image import MIMEImage from email.mime.multipart import MIMEMultipart from email.header import Header from email.utils import formataddr # 第三方 SMTP 服务 mail_host = "smtp.qq.com" # 设置服务器 mail_user = "xxx@qq.com" # 用户名 mail_pass = "ytulertyfgbnffd" # 口令 sender = "xxx@qq.com" # 发送者的邮箱 receivers = ["yyy@qq.com"] # 接收邮件,其他人的邮箱 # 创建一个根实例 msgRoot = MIMEMultipart("related") msgRoot["From"] = formataddr(["ZBJ", sender]) # 发送人 msgRoot["To"] = formataddr(["小明", receivers[0]]) # 接收人 subject = 'HTML带图片的邮件测试' msgRoot['Subject'] = Header(subject, 'utf-8') # 邮件主题 # 创建一个存放正文的实例,并添加进根实例 msgAlternative = MIMEMultipart('alternative') msgRoot.attach(msgAlternative) mail_msg = """ <p>Python 邮件发送测试...</p> <p>图片演示:</p> <p><img src="cid:0"></p> """ msgAlternative.attach(MIMEText(mail_msg, 'html', 'utf-8')) # 创建图片实例,并添加进根实例 fp = open('mypicture.png', 'rb') msgImage = MIMEImage(fp.read()) fp.close() # 定义图片 ID,在 HTML 文本中引用 msgImage.add_header('Content-ID', '<0>') msgRoot.attach(msgImage) try: smtpObj = smtplib.SMTP_SSL() smtpObj.connect(mail_host, 465) smtpObj.login(mail_user, mail_pass) smtpObj.sendmail(sender, receivers, msgRoot.as_string()) print("邮件发送成功") smtpObj.quit() except smtplib.SMTPException: print("Error: 无法发送邮件")
结果如下: