python 邮件模块

    Python内置对SMTP的支持，其中细化为smtplib和email两个模块，email负责构造邮件，smtplib负责发送邮件，我们仅仅需要编辑相关配置即可

1. 获取认证

    在获取认证这一块我们需要编辑的配置就是我们的邮箱账户以及授权码了，两者都可以在电子邮箱的账户配置中找到，这里以QQ邮箱做案例

image.png

2. STMP属性

    smtplib模块负责邮件的发送，可以通过from smtplib import SMTP导入模块并通过help(SMTP)查看相应用法，我们通过server = smtplib.SMTP(smtp_server, port)构建一个server对象，然后参照以下方法执行相关配置

方法	描述
SMTP.set_debuglevel(level)	设置输出debug调试信息，默认不输出
SMTP.docmd(cmd[, argstring])	发送一个命令到SMTP服务器
SMTP.connect([host[, port]])	连接到指定的SMTP服务器
SMTP.helo([hostname])	使用helo指令向SMTP服务器确认你的身份
SMTP.ehlo(hostname)	使用ehlo指令像ESMTP（SMTP扩展）确认你的身份
SMTP.ehlo_or_helo_if_needed()	如果在以前的会话连接中没有提供ehlo或者helo指令，这个方法会调用ehlo()或helo()
SMTP.has_extn(name)	判断指定名称是否在SMTP服务器上
SMTP.verify(address)	判断邮件地址是否在SMTP服务器上
SMTP.starttls([keyfile[, certfile]])	使SMTP连接运行在TLS模式，所有的SMTP指令都会被加密
SMTP.login(user, password)	登录SMTP服务器
SMTP.sendmail(from_addr, to_addrs, msg, mail_options=[], rcpt_options=[])	发送邮件 （from_addr：邮件发件人） （to_addrs：邮件收件人） （msg：发送消息）
SMTP.quit()	关闭SMTP会话
SMTP.close()	关闭SMTP服务器连接

3. 发送邮件

    简单的邮件可以通过MIMEText构建信息然后调用sendmail方法即可，但是这样的简单处理不会显示发送人、收件人、主题等等。

from email.mime.text import MIMEText
msg = MIMEText('your message', 'plain', 'utf-8')

• 这里可以通过改变信息类型的值选择传输不同的文本，比如这里的plain改成html就可以在信息中通过HTML格式输出,MIME相关内容可以参考MIME 类型

    邮件主题、发件人、收件人等信息包含于MTA文本中的我们只需要简单配置几行代码

def _format_addr(s):
    name, addr = parseaddr(s)
    return formataddr((Header(name, 'utf-8').encode(), addr))

msg = MIMEText('your message', 'plain', 'utf-8')
msg['From'] = _format_addr('Maya <%s>' % from_addr)
msg['To'] = _format_addr('Receiver <%s>' % to_addr)
msg['Subject'] = Header('Your Subject……', 'utf-8').encode()

• 很多邮件中会将用户和邮箱做如下显示：user ,email.utils.parseaddr则是用来专门解析邮件地址的，把它解析为一个列表，第一项是用户名, 第二项是邮箱地址
• 邮件中包含中文的话，需要通过Header对象进行编码
• msg['To']接收的是字符串而不是list，如果有多个邮件地址，用,分隔

4. 附件添加

    带附件的邮件可以看做包含若干部分的邮件：文本和各个附件本身，所以，可以构造一个MIMEMultipart对象代表邮件本身，然后往里面加上一个MIMEText作为邮件正文，再继续往里面加上表示附件的MIMEBase对象即可,简单来说就是首先用MIMEMultipart来标明邮件由多个部分构成，通过add_header等方法进行附件的声明

MIMEBase
    |-- MIMENonMultipart
        |-- MIMEApplication
        |-- MIMEAudio
        |-- MIMEImage
        |-- MIMEMessage
        |-- MIMEText
    |-- MIMEMultipart

    一般来说，不会用到MIMEBase，而是直接使用它的继承类。MIMEMultipart有attach方法，而MIMENonMultipart没有，只能被attach。
MIME上述等支持的类型，如果附件是图片格式，我要用MIMEImage，如果是音频，要用MIMEAudio，可以根据类型判定，也可以直接使用MIMEApplication，MIMEApplication默认子类型是application/octet-stream(二进制文件)

---

class email.mime.base.MIMEBase（_maintype，_subtype，** _ params ）

---

    这是所有MIME特定子类的基类 Message。通常你不会特别创建实例MIMEBase，尽管你可以。 MIMEBase 主要是为更具体的MIME感知子类提供方便的基类。

• *_maintype*是*Content-Type*主要类型（例如文本 或图像），_ subtype是*Content-Type*次要类型（例如*plain*或*gif*）。 *_params*是一个参数键/值字典，直接传递给Message.add_header。

• 该MIMEBase班总是增加了一个内容类型头（基于*_maintype*，*_subtype*和*_params*）和 *MIME-版本*头（始终设置为1.0）。

• 可以通过mimetypes.guess_type（url，strict = True ）判断具体类型,无法判断就统一设置成二进制文件

        ctype, encoding = mimetypes.guess_type(filePath)
        if ctype is None or encoding is not None:
            ctype = 'application/octet-stream'
        maintype, subtype = ctype.split('/', 1)

5. 具体操作

# 邮件对象:
msg = MIMEMultipart()
msg['From'] = _format_addr('Your message <%s>' % from_addr)
msg['To'] = _format_addr('Your name <%s>' % to_addr)
msg['Subject'] = Header('Your Subject……', 'utf-8').encode()

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

# 添加附件就是加上一个MIMEBase，从本地读取一个图片:
with openfilePath, 'rb') as f:
    # 设置附件的MIME和文件名，这里是png类型:
    mime = MIMEBase(maintype, subtype, filename)
    # 加上必要的头信息:
    mime.add_header('Content-Disposition', 'attachment', filename)
    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)

6. 加密传输

    使用标准的25端口连接SMTP服务器时，使用的是明文传输，发送邮件的整个过程可能会被窃听。要更安全地发送邮件，可以加密SMTP会话，实际上就是先创建SSL安全连接，然后再使用SMTP协议发送邮件，QQ邮箱也是支持SSL加密的

QQ邮箱
接收邮件服务器：pop.qq.com，使用SSL，端口号995
发送邮件服务器：smtp.qq.com，使用SSL，端口号465或587

image.png

smtp_server = 'smtp.qq.com'
smtp_port = 587
server = smtplib.SMTP(smtp_server, smtp_port)
server.starttls()
# 剩下的代码和前面的一模一样:
server.set_debuglevel(1)
...

7. 总结

• STMP同样支持图片的传输以及在正文中显示，用处并不广泛不做概述
• 可以设定一个布尔值利用try catch接收邮件发送的返回码做后续处理
• From、To 要与 sendmail中的前两个参数保持一致
• To 多个邮箱用逗号隔开，sendmail 中的第二个参数要用 list
• subject 中不能含有 test 关键字，否则会被视为垃圾邮件

Reference

• SMTP发送邮件
• 代码案例