Flask扩展 -- flask-mail

Posted CloudArrows

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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

 

以上是关于Flask扩展 -- flask-mail的主要内容,如果未能解决你的问题,请参考以下文章

flask-mail的使用

Flask之邮件扩展

Flask扩展系列:Mail

Python Flask教程学习03

Python Flask教程学习03

Flask-mail 发邮件慢(即使异步)