Flask扩展 -- flask-mail

电子邮件是最常用的通信方式之一。虽然Python标准库中的smtplib包可用在Flask程序中发送电子邮件，但包装了smtplib的Flask-Mail扩展能更好的和Flask集成。

1.安装Flask-Mail

1.1使用pip安装

pip install flask-mail

1.2 下载源码安装

git clone https://github.com/mattupstate/flask-mail.git
cd flask-mail
python setup.py install

2.flask-mail初始化

from flask import Flask
from flask_mail import Mail, Message

app = Flask(__name__)
mail = Mail(app)

3.Flask-Mail 配置

3.1 Flask-Mail常用配置项

Flask-Mail通过标准的Flask配置API进行配置，这些常用的配置项如下：

配置	默认值	说明
MAIL_SERVER	localhost	电子邮件服务器的主机名或IP地址
MAIL_PORT	25	电子邮件服务器的端口
MAIL_USE_TLS	False	启用传输层安全（Transport Layer Security，TLS）协议
MAIL_USE_SSL	Flase	启用安全套接层（Secure Sockets Layer，SSL）协议
MAIL_USERNAME	None	邮件账户的用户名
MAIL_PASSWORD	None	邮件账户的密码
MAIL_DEFAULT_SENDER	None	默认发件人，如果Message对象里没指定发件人，就采用默认发件人
MAIL_MAX_EMAILS	None	邮件批量发送个数上限，默认为没有上限
MAIL_SUPPRESS_SEND	app.testing	调用“Mail.send()”方法后，邮件不会真的被发送，在测试环境中使用，默认为False
MAIL_ASCII_ATTACHMENTS	Flase	将附件的文件名强制转换为ASCII字符，避免在某些情况下出现乱码

3.2 常见的SMTP邮箱服务配置

(1)配置QQ邮箱服务器

MAIL_SERVER = 'smtp.qq.com',
MAIL_PROT = 25,
MAIL_USE_TLS = True,
MAIL_USE_SSL = False,
MAIL_USERNAME = "",
MAIL_PASSWORD = "",

QQ邮箱的配置方式如下：

 开启了授权之后，就会弹出生成授权码页面：

 注意：

a.qq邮箱的服务器地址为smtp.qq.com;

b.邮箱服务的端口为25或者465都可以;

c.TLS,SSL的选择很多人发不出去邮件的关键之一，这里QQ邮箱选择TLS；

d.账号和密码需要特别注意，这里的账号是自己的QQ邮箱账号，密码不是QQ邮箱密码，而是生成的授权码；

(2)其他邮箱后续补充

4. 简单功能实现

下面举例说明flask-email扩展是如何实现简单邮件发送的：

from flask import Flask
from flask_mail import Mail, Message

app = Flask(__name__)
app.config.update(
    MAIL_SERVER='smtp.qq.com',
    MAIL_PROT=465,
    MAIL_USE_TLS=True,
    MAIL_USE_SSL=False,
    MAIL_USERNAME="xxxxxxxxxxxxx@qq.com",
    MAIL_PASSWORD="****************",
)

mail = Mail(app)

@app.route('/')
def index():
# sender 发送方，recipients 邮件接收方列表
    msg = Message("Hi!This is a test ",sender='xxxxxxxxxxxxxx@qq.com', recipients=['test@example.com'])
# msg.body 邮件正文
    msg.body = "This is a first email"
    mail.send(msg)
    print("Mail sent")
    return 'send successfully'

if __name__ == "__main__": app.run(debug=True)

 如果想发送信息，首先需要创建一个Message实例：

msg = Message("Hello",sender="from@example.com",recipients=["to@example.com"])

当然，我们也可以单独添加邮件接收对象：

msg.recipients = ["you@example.com"]
msg.add_recipient("somebodyelse@example.com")

在配置参数的时候，如果我们设置了MAIL_DEFAULT_SENDER参数，在后面创建message实例时不需要清楚指明邮件发送方，此时程序会自动获取默认配置：

msg = Message("Hello",recipients=["to@example.com"])

5.异步发送邮件

使用上面的方式发送邮件，会发现页面卡顿了几秒才出现消息，这是因为我们使用了同步的方式。为了避免发送邮件过程中出现的延迟，我们把发送邮件的任务移到后台线程中。代码如下：

# -*- coding:utf-8 -*-

from flask import Flask
from flask_mail import Mail, Message
from threading import Thread
import os

app = Flask(__name__)

app.config['MAIL_SERVER'] = 'smtp.qq.com'
app.config['MAIL_PORT'] = 25
app.config['MAIL_USE_TLS'] = True
app.config['MAIL_USERNAME'] = os.environ.get('MAIL_USERNAME') or 'xxxxxxxxxx@qq.com'
app.config['MAIL_PASSWORD'] = os.environ.get('MAIL_PASSWORD') or '*********'

mail = Mail(app)

def send_async_email(app, msg):
    with app.app_context():
        mail.send(msg)

@app.route('/sync')
def send_email():
    msg = Message('Hi', sender='xxxxxxxx@qq.com', recipients=['test@example.com'])
    msg.html = '<b>send email asynchronously</b>'

    thr = Thread(target=send_async_email, args=[app, msg])
    thr.start()
    return 'send successfully'

if __name__ == '__main__':
    app.run(debug=True)

 在上面，我们创建了一个线程，执行的任务是send_async_email，该任务的实现涉及一个问题：

很多 Flask 扩展都假设已经存在激活的程序上下文和请求上下文。Flask-Mail 中的 send() 函数使用 current_app，因此必须激活程序上下文。不过，在不同线程中执行 mail.send() 函数时，程序上下文要使用 app.app_context()人工创建。

6.带附件的邮件

有时候，我们发邮件的时候需要添加附件，比如文档和图片等，这也很简单，代码如下：

# -*- coding: utf-8 -*-

from flask import Flask
from flask_mail import Mail, Message
import os

app = Flask(__name__)

app.config['MAIL_SERVER'] = 'smtp.qq.com'
app.config['MAIL_PORT'] = 25
app.config['MAIL_USE_TLS'] = True
app.config['MAIL_USERNAME'] = os.environ.get('MAIL_USERNAME') or 'xxxxxxxxx@qq.com'
app.config['MAIL_PASSWORD'] = os.environ.get('MAIL_PASSWORD') or '**********'

mail = Mail(app)

@app.route('/attach')
def add_attchments():
    msg = Message('A photo', sender='xxxxxxxxx@qq.com', recipients=['ltest@example.com'])
    msg.html = '<b>A beautiful photo!</b>'

    with app.open_resource("1111.jpg") as fp:
        msg.attach("photo.jpg", "image/jpeg", fp.read())

    mail.send(msg)
    return '<h1>OK!</h1>'

if __name__ == '__main__':
    app.run(debug=True)

上面的代码中，我们通过 app.open_resource(path_of_attachment) 打开了本机的某张图片，然后通过msg.attach() 方法将附件内容添加到 Message 对象。msg.attach() 方法的第一个参数是附件的文件名，第二个参数是文件内容的 MIME (Multipurpose Internet Mail Extensions) 类型，第三个参数是文件内容。

7.批量发送

在某些情况下，我们需要批量发送邮件，比如给网站的所有注册用户发送改密码的邮件，这时为了避免每次发邮件时都要创建和关闭跟服务器的连接，我们的代码需要做一些调整，类似如下：

with mail.connect() as conn:
    for user in users:
        subject = "hello, %s" % user.name
        msg = Message(recipients=[user.email], body='...', subject=subject)
        conn.send(msg)

上面的工作方式，使得应用与电子邮件服务器保持连接，一直到所有邮件已经发送完毕。某些邮件服务器会限制一次连接中的发送邮件的上限，这样的话，你可以配置 MAIL_MAX_EMAILS。