[转载]Python SMTP发送邮件-smtplib模块

在进入正题之前,我们需要对一些基本内容有所了解:常用的电子邮件协议有SMTP、POP3、IMAP4,它们都隶属于TCP/IP协议簇,默认状态下,分别通过TCP端口25、110和143建立连接。

Python内置对SMTP的支持,该协议支持发送纯文本邮件、HTML邮件以及带附件的邮件,

Python的smtplib,email模块都支持该协议。

SMTP(Simple Mail Transfer Protocol)即简单邮件传输协议,它是一组用于由源地址到目的地址传送邮件的规则,由它来控制信件的中转方式。

发邮件需要掌握两个模块的用法,smtplib和email,这俩模块是python自带的,只需import即可使用。

smtplib模块主要负责发送邮件,email模块主要负责构造邮件。

smtplib模块主要负责发送邮件:是一个发送邮件的动作,连接邮箱服务器,登录邮箱,发送邮件(有发件人,收信人,邮件内容)。

email模块主要负责构造邮件:指的是邮箱页面显示的一些构造,如发件人,收件人,主题,正文,附件等。

第一步,首先你要准备两个邮箱帐号,一个是常用的(接收端),
另一个可以注册网易163邮箱或者foxmail邮箱也可(发送端),
本次我使用两个QQ邮箱进行演示。首先在邮箱的 设置- 账户中开启 SMTP功能

第二步,点击 生成授权码,按照弹出窗口的提示发送短信,发送后单击 我已发送按钮 将生成的授权码复制下来以备接下来使用。

QQ 邮箱 SMTP 服务器地址:http://smtp.qq.com,ssl 端口:465。授权码是下面案例中的密码

1.smtplib模块

smtplib使用较为简单。以下是最基本的语法。

导入及使用方法如下:

import smtplib
smtp = smtplib.SMTP() 
smtp.connect('smtp.qq.com,465') 
smtp.login(username, password) 
smtp.sendmail(send_add, to_add, msg.as_string()) 
smtp.quit()

说明:

smtplib.SMTP():实例化SMTP()

connect(host,port):

host:指定连接的邮箱服务器。常用邮箱的smtp服务器地址如下:

新浪邮箱:smtp.sina.com,
新浪VIP:smtp.vip.sina.com,
搜狐邮箱:http://smtp.sohu.com
126邮箱:smtp.126.com,
139邮箱:smtp.139.com,
163网易邮箱:http://smtp.163.com

port:指定连接服务器的端口号,默认为25. 默认很可能会失败,端口号具体内容需要查询邮件服务提供商

login(user,password):

user:登录邮箱的用户名。

password:登录邮箱的密码,像笔者用的是QQ邮箱,QQ邮箱一般是网页版,需要用到客户端密码,需要在网页版的QQ邮箱中设置授权码,该授权码即为客户端密码。

sendmail(from_addr,to_addrs,msg,...):

from_addr:邮件发送者地址

to_addrs:邮件接收者地址。字符串列表['接收地址1','接收地址2','接收地址3',...]或'接收地址'

msg:发送消息:邮件内容。一般是msg.as_string():as_string()是将msg(MIMEText对象或者MIMEMultipart对象)变为str。

quit():用于结束SMTP会话。

2.email模块

email模块下有mime包,mime英文全称为“Multipurpose Internet Mail Extensions”,即多用途互联网邮件扩展,是目前互联网电子邮件普遍遵循的邮件技术规范。

该mime包下常用的有三个模块:text*,image,*multpart

导入方法如下:

from email.mime.multipart import MIMEMultipart    
from email.mime.text import MIMEText    
from email.mime.image import MIMEImage

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

Message
+- MIMEBase
   +- MIMEMultipart
   +- MIMENonMultipart
      +- MIMEMessage
      +- MIMEText
      +- MIMEImage

2.1 text说明

邮件发送程序为了防止有些邮件阅读软件不能显示处理HTML格式的数据,通常都会用两类型分别为"text/plain"和"text/html"

构造MIMEText对象时,第一个参数是邮件正文,第二个参数是MIME的subtype,最后一定要用utf-8编码保证多语言兼容性。

2.1.1添加普通文本
text = "Hi!\nHow are you?\nHere is the link you wanted:\nhttp://www.zhihu.com"    
text_plain = MIMEText(text,'plain', 'utf-8')

查看MIMEText属性:可以观察到MIMEText,MIMEImage和MIMEMultipart的属性都一样。

print dir(text_plain)

['contains', 'delitem', 'doc', 'getitem', 'init', 'len', 'module', 'setitem', 'str', '_charset', '_default_type', '_get_params_preserve', '_headers', '_payload', '_unixfrom', 'add_header', 'as_string', 'attach', 'defects', 'del_param', 'epilogue', 'get', 'get_all', 'get_boundary', 'get_charset', 'get_charsets', 'get_content_charset', 'get_content_maintype', 'get_content_subtype', 'get_content_type', 'get_default_type', 'get_filename', 'get_param', 'get_params', 'get_payload', 'get_unixfrom', 'has_key', 'is_multipart', 'items', 'keys', 'preamble', 'replace_header', 'set_boundary', 'set_charset', 'set_default_type', 'set_param', 'set_payload', 'set_type', 'set_unixfrom', 'values', 'walk']

import smtplib
from email.mime.text import MIMEText
from email.header import Header
# 第三方 SMTP 服务
mail_host = "smtp.qq.com"  # 设置服务器
mail_user = "******@qq.com"  # 用户名
mail_pass = "famaiqllddfsbjag"  # 授权码
sender = '******@qq.com'
receivers = ['****@qq.com']  # 接收邮件,可设置为你的QQ邮箱或者其他邮箱
message = MIMEText('Python 邮件发送测试...', 'plain', 'utf-8')
message['From'] = Header("Python SMTP教程", 'utf-8') #括号里的对应发件人邮箱昵称(随便起)、发件人邮箱账号
message['To'] = Header("测试", 'utf-8') #括号里的对应收件人邮箱昵称、收件人邮箱账号
subject = 'Python SMTP 邮件测试'
message['Subject'] = Header(subject, 'utf-8')
try:
    smtpObj = smtplib.SMTP()
    smtpObj.connect(mail_host, 465)  # 发件人邮箱中的SMTP服务器,端口是465
    smtpObj.login(mail_user, mail_pass)
    smtpObj.sendmail(sender, receivers, message.as_string())
    print("邮件发送成功")
except smtplib.SMTPException:
    print("Error: 无法发送邮件")
2.1.2添加超文本

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 = "*********@qq.com"  # 用户名
mail_pass = "famaiqllddfsbjag"  # 授权码
sender = '********@qq.com'
receivers = ['*********@qq.com']  # 接收邮件,可设置为你的QQ邮箱或者其他邮箱
#使用Python发送HTML格式的邮件
mail_msg = """
<p>Python 邮件发送测试...</p>
<p><a href="http://www.zhihu.com">这是一个链接</a></p>
"""
message = MIMEText(mail_msg, 'html', 'utf-8')
message['From'] = Header("Python smtp教程", 'utf-8') #括号里的对应发件人邮箱昵称(随便起)、发件人邮箱账号
message['To'] = Header("测试", 'utf-8') #括号里的对应收件人邮箱昵称、收件人邮箱账号
subject = 'Python SMTP 邮件测试'
message['Subject'] = Header(subject, 'utf-8')
try:
    smtpObj = smtplib.SMTP()
    smtpObj.connect(mail_host, 465)  # 发件人邮箱中的SMTP服务器,端口是465
    smtpObj.login(mail_user, mail_pass)
    smtpObj.sendmail(sender, receivers, message.as_string())
    print("邮件发送成功")
except smtplib.SMTPException:
    print("Error: 无法发送邮件")
2.1.3 image说明
import smtplib
from email.mime.image import MIMEImage
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.header import Header
# 第三方 SMTP 服务
mail_host = "smtp.qq.com"  # 设置服务器
mail_user = "****@qq.com"  # 用户名
mail_pass = "famaiqllddfsbjag"  # 授权码
sender = '*****@qq.com'
receivers = ['*****@qq.com']  # 接收邮件,可设置为你的QQ邮箱或者其他邮箱
msgRoot = MIMEMultipart('related')
msgRoot['From'] = Header("发送者", 'utf-8')
msgRoot['To'] = Header("测试", 'utf-8')
subject = 'Python SMTP 邮件测试'
msgRoot['Subject'] = Header(subject, 'utf-8')
msgAlternative = MIMEMultipart('alternative')
msgRoot.attach(msgAlternative)
mail_msg = """
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Send mail Tets</title>
</head>
<body>
<img src="cid:jpg1" width="400" height="400" alt="">  <br><br>
</body>
</html>
"""
msgAlternative.attach(MIMEText(mail_msg, 'html', 'utf-8'))
# 指定图片为当前目录
with open('4.jpg', 'rb') as image_file:
    msgImage = MIMEImage(image_file.read())
# 定义图片 ID,在 HTML 文本中引用
msgImage.add_header('Content-ID', 'jpg1')
msgRoot.attach(msgImage)
try:
    smtpObj = smtplib.SMTP()
    smtpObj.connect(mail_host, 465)  # 发件人邮箱中的SMTP服务器,端口是465
    smtpObj.login(mail_user, mail_pass)
    smtpObj.sendmail(sender, receivers, msgRoot.as_string())
    print("邮件发送成功")
except smtplib.SMTPException:
    print("Error: 无法发送邮件")
2.1.4添加附件

发送带附件的邮件,首先要创建MIMEMultipart()实例,然后构造附件,如果有多个附件,可依次构造,最后利用smtplib.smtp发送。

import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from email.header import Header
sender = '**********@qq.com'
receivers = ['**********@qq.com']  # 接收邮件,可设置为你的QQ邮箱或者其他邮箱
#创建一个带附件的实例
message = MIMEMultipart()
message['From'] = Header("Python SMTP教程", 'utf-8')
message['To'] =  Header("测试", 'utf-8')
subject = 'Python SMTP 邮件测试'
message['Subject'] = Header(subject, 'utf-8')
#邮件正文内容
message.attach(MIMEText('这是Python 邮件发送测试……', 'plain', 'utf-8'))
# 构造附件1,传送当前目录下的 test.txt 文件
att_annex1 = MIMEText(open('test.txt', 'rb').read(), 'base64', 'utf-8')
att_annex1["Content-Type"] = 'application/octet-stream'
# 这里的filename可以任意写,写什么名字,邮件中显示什么名字
att_annex1["Content-Disposition"] = 'attachment; filename="test.txt"'
message.attach(att_annex1)
# 构造附件2,传送当前目录下的 test2.txt 文件
att_annex2 = MIMEText(open('test2.txt', 'rb').read(), 'base64', 'utf-8')
att_annex2["Content-Type"] = 'application/octet-stream'
att_annex2["Content-Disposition"] = 'attachment; filename="test_file.txt"'
message.attach(att_annex2)
try:
    smtpObj = smtplib.SMTP('localhost')
    smtpObj.sendmail(sender, receivers, message.as_string())
    print "邮件发送成功"
except smtplib.SMTPException:
    print "Error: 无法发送邮件"

2.3 multpart说明

常见的multipart类型有三种:multipart/alternative, multipart/related和multipart/mixed。

邮件类型为"multipart/alternative"的邮件包括纯文本正文(text/plain)和超文本正文(text/html)。

邮件类型为"multipart/related"的邮件正文中包括图片,声音等内嵌资源。

邮件类型为"multipart/mixed"的邮件包含附件。向上兼容,如果一个邮件有纯文本正文,超文本正文,内嵌资源,附件,则选择mixed类型。

msg = MIMEMultipart('mixed')

我们必须把Subject,From,To,Date添加到MIMEText对象或者MIMEMultipart对象中,邮件中才会显示主题,发件人,收件人,时间(若无时间,就默认一般为当前时间,该值一般不设置)。

msg = MIMEMultipart('mixed') 
msg['Subject'] = 'Python email test'
msg['From'] = 'XXX@qq.com <XXX@qq.com>'
msg['To'] = 'XXX@qq.com'
msg['Date']='2020-10-16'

查看MIMEMultipart属性:

msg = MIMEMultipart('mixed') 
print dir(msg)

结果:

['contains', 'delitem', 'doc', 'getitem', 'init', 'len', 'module', 'setitem', 'str', '_charset', '_default_type', '_get_params_preserve', '_headers', '_payload', '_unixfrom', 'add_header', 'as_string', 'attach', 'defects', 'del_param', 'epilogue', 'get', 'get_all', 'get_boundary', 'get_charset', 'get_charsets', 'get_content_charset', 'get_content_maintype', 'get_content_subtype', 'get_content_type', 'get_default_type', 'get_filename', 'get_param', 'get_params', 'get_payload', 'get_unixfrom', 'has_key', 'is_multipart', 'items', 'keys', 'preamble', 'replace_header', 'set_boundary', 'set_charset', 'set_default_type', 'set_param', 'set_payload', 'set_type', 'set_unixfrom', 'values', 'walk']

说明:

msg.add_header(_name,_value,**_params):添加邮件头字段。

msg.as_string():是将msg(MIMEText对象或者MIMEMultipart对象)变为str,

如果只有一个html超文本正文或者plain普通文本正文的话,一般msg的类型可以是MIMEText;

如果是多个的话,就都添加到MIMEMultipart,msg类型就变为MIMEMultipart。

msg.attach(MIMEText对象或MIMEImage对象):

​ 将MIMEText对象或MIMEImage对象添加到MIMEMultipart对象中。

​ MIMEMultipart对象代表邮件本身,MIMEText对象或MIMEImage对象代表邮件正文。

以上的构造的文本,超文本,附件,图片都可以添加到MIMEMultipart('mixed')中:

msg.attach(text_plain)    
msg.attach(text_html)    
msg.attach(text_att)    
msg.attach(image)

附加案例:

文字,html,图片,附件实现案例:

# 发送邮件
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
import os


# 设置smtplib所需的参数
# 下面的发件人,收件人是用于邮件传输的。
HOST = "smtp.qq.com"                 # smtp服务器地址
PORT = '465'                         # smtp服务器端口号
from_addr = "********@qq.com"        # 发送邮件的账号
qqCode = "famakkldfsbjag"          # 登陆授权码
to_addr = ["*******@qq.com"]          # 接收邮件的账号 这里可以是一个列表,多个收件邮箱


# 构造邮件对象MIMEMultipart对象
# 下面的主题,发件人,收件人,日期是显示在邮件页面上的。
message = MIMEMultipart('mixed')
subject = 'Python SMTP 邮件测试'                         # 邮件主题/标题
message['Subject'] = Header(subject, 'utf-8')           # 通过Header对象编码的文本,包含utf-8编码信息和Base64编码信息
message['From'] = Header(from_addr, 'utf-8')            # 括号里的对应发件人邮箱昵称(随便起)、发件人邮箱账号
message['To'] = Header(';'.join(to_addr), 'utf-8')      # 收件人为多个收件人,通过join将列表转换为以;为间隔的字符串
# message['To'] = Header(to_addr, 'utf-8')              # 括号里的对应收件人邮箱昵称、收件人邮箱账号

# 构造文字内容
msg_text = """
Hi!
How are you?
Here is the link you wanted:
https://www.zhihu.com/
"""
text_file_path = "test1.txt"

def msg_text_attach(plain_text):
    """读取文件或者使用变量传递纯文本"""
    if os.path.isfile(plain_text):
        """如果传递的是路径,则读取文本"""
        with open(plain_text, 'rb') as text_file:
            plain_text = text_file.read()
    msg_text_plain = MIMEText(plain_text, 'plain', 'utf8')
    message.attach(msg_text_plain)


msg_text_attach(msg_text)


# 构造HTML内容
html_content = """
    <html>  
      <head></head>  
      <body>  
         <p>Python 邮件发送测试...<br>  
           How are you?<br>  
           Here is the <a href="http://www.zhihu.com/people/4k8k">link</a> you wanted.<br> 
         </p> 
      </body>  
    </html>  
    """


def html_text_attach(html_text):
    """不需要做替换掉 html构造"""
    html_msg = MIMEText(html_text, 'html', 'utf-8')
    message.attach(html_msg)


# html_text_attach(html_content)


def msg_text_html_attach(html_text_file):
    """构造一个需要替换图片的html"""
    msg_alternative = MIMEMultipart('alternative')
    message.attach(msg_alternative)
    try:
        with open(html_text_file, 'r', encoding='utf8') as html_file:
            html_text_content = html_file.read()
    except Exception as eh:
        print('未找到html文件', eh)
    msg_alternative.attach(MIMEText(html_text_content, 'html', 'utf8'))


def add_image(image_path, cid):
    # 指定图片为当前目录
    with open(image_path, 'rb') as image_file:
        msg_image = MIMEImage(image_file.read())

    # 定义图片id,在html文本中引用
    msg_image.add_header('Content-ID', cid)
    message.attach(msg_image)


# 使用字典保存HTML文件路径
html_file_path = {
    "html1": "使用教程.html",
    "html2": "test_send.html"
}

image_paths = {
    "image1": "./image/主图1.jpg",
    "image2": "./image/主图2.jpg",
    "image3": "./image/主图3.jpg",
    "image4": "./image/场景.jpg"
}

image_cids = {
    "image1": "jpg1",
    "image2": "jpg2",
    "image3": "jpg3",
    "image4": "jpg4"

}

msg_text_html_attach(html_file_path.get("html2"))
add_image(image_paths.get('image1'), image_cids.get('image1'))  # 替换cid1
add_image(image_paths.get('image2'), image_cids.get('image2'))  # 替换cid2
add_image(image_paths.get('image3'), image_cids.get('image3'))  # 替换cid3
add_image(image_paths.get('image4'), image_cids.get('image4'))  # 替换cid4


"""
html2即 test_send.html内容如下
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Send mail Tets</title>
</head>
<body>
<img src="cid:jpg1" width="400" height="400" alt="">  <br><br>
<img src="cid:jpg2" width="400" height="400" alt="">  <br><br>
<img src="cid:jpg3" width="400" height="400" alt="">  <br><br>
<img src="cid:jpg4" width="400" height="400" alt="">
</body>
</html>

"""


# 构造图片链接


def image_attach(image_file_path, imgid, filename=None):
    if filename is None:
        """如果不重命名文件,则默认使用源文件名"""
        filename = image_file_path
    try:
        with open(image_file_path, 'rb') as image_file:
            image_content = image_file.read()
    except Exception as ei:
        print('未找到图片文件', ei)
    image = MIMEImage(image_content)
    image.add_header('Content-ID', imgid)   # image1是照片别名,可以在HTML代码中引用
    image['Content-Disposition'] = f'attachment; filename={filename}'
    message.attach(image)


image_attach('test.jpg', 'image1', 'test_image.jpg')

# 构造附件


def send_annex_file(annex_file_path, annex_filename=None):
    """传入附加文件路径和文件名(重命名附件,可以省略,默认为源文件名)"""
    if annex_filename is None:
        annex_filename = annex_file_path
    try:
        with open(annex_file_path, 'rb') as annex_file:
            send_file = annex_file.read()
    except Exception as es:
        print('未找到附件', es)

    text_appendix = MIMEText(send_file, 'base64', 'utf-8')
    text_appendix["Content-Type"] = 'application/octet-stream'
    # 以下附件可以重命名成:核心数据.xlsx
    # text_appendix["Content-Disposition"] = 'attachment; filename="核心数据.xlsx"'
    # 另一种附件重命名实现方式
    text_appendix.add_header('Content-Disposition', 'attachment', filename=annex_filename)
    message.attach(text_appendix)


# 使用字典保存文件路径
annex_path = {
    "file1": "核心数据.xlsx",
    "file2": "test1.txt",
    "file3": "使用教程.html"
}
send_annex_file(annex_path["file1"], '核心数据报表.xlsx')
send_annex_file(annex_path["file2"])
send_annex_file(annex_path.get('file3'))

"""
邮件类型为"multipart/alternative"的邮件包括纯文本正文(text/plain)
和超文本正文(text/html)。
邮件类型为"multipart/related"的邮件正文中包括图片,声音等内嵌资源。
邮件类型为"multipart/mixed"的邮件包含附件。向上兼容,
如果一个邮件有纯文本正文,超文本正文,内嵌资源,附件,则选择mixed类型。
"""

# 配置服务器 发送邮件
try:
    # 配置服务器

    # smtp = smtplib.SMTP()                    # 1 创建SMTP实例
    # smtp.connect('smtp.qq.com', PORT)        # 2 连接SMTP服务器
    server = smtplib.SMTP_SSL(HOST, PORT)     # 本例这里直接一步到位
    # #打印出和SMTP服务器交互的所有信息
    # server.set_debuglevel(1)    # python里打印出来的内容是红色的,有点像报错,这里屏蔽了,可以正常发邮件
    # 登录SMTP服务器
    server.login(from_addr, qqCode)
    # 发送邮件,由于可以一次发给多个人,所以传入一个list,邮件正文是一个str,as_string()把MIMEText对象变成str
    server.sendmail(from_addr, to_addr, message.as_string())
    server.quit()
    print('--邮件发送成功--')
except Exception as e:
    print('--邮件发送失败--' + str(e))


#  说明html和text纯文本内容不能同时存在,html会覆盖掉text纯文本
  • 0
    点赞
  • 18
    收藏
    觉得还不错? 一键收藏
  • 1
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值