Flask 邮件

网页应用经常需要具备向用户/客户发送邮件的功能。 Flask-Mail 扩展使得用任何邮件服务器建立一个简单的接口非常容易。

首先，应使用pip工具安装Flask-Mail扩展。

pip install Flask-Mail

然后，需要通过设置以下应用程序参数的值来配置Flask-Mail。

序号	参数及描述
1	MAIL_SERVER 邮件服务器的名称/IP地址
2	MAIL_PORT 服务器使用的端口号
3	MAIL_USE_TLS 启用/禁用传输安全层加密
4	MAIL_USE_SSL 启用/禁用安全套接字层加密
5	MAIL_DEBUG 调试支持。默认为Flask应用程序的调试状态
6	MAIL_USERNAME 发件人用户名
7	MAIL_PASSWORD 发件人密码
8	MAIL_DEFAULT_SENDER 设置默认发件人
9	MAIL_MAX_EMAILS 设置最大发送邮件数
10	MAIL_SUPPRESS_SEND 如果app.testing设置为true，则发送被抑制
11	MAIL_ASCII_ATTACHMENTS 如果设置为true，则附加的文件名转换为ASCII

flask-mail模块包含以下重要类的定义。

Mail类

它管理电子邮件消息的需求。类构造函数采用以下形式-

flask-mail.Mail(app = None)

构造函数以Flask应用程序对象作为参数。

Mail类的方法

序号	方法和描述
1	send() 发送Message类对象的内容
2	connect() 打开与邮件主机的连接
3	send_message() 发送消息对象

信息类

它封装了一封电子邮件。消息类的构造函数有几个参数 –

flask-mail.Message(subject, recipients, body, html, sender, cc, bcc, 
   reply-to, date, charset, extra_headers, mail_options, rcpt_options)

消息类方法

attach() - 添加附件到消息。该方法接受以下参数 –

filename - 要附加的文件名
content_type - 文件的MIME类型
data - 原始文件数据
disposition - 内容的位置，如果有的话。

add_recipient() - 添加其他收件人到消息

在以下示例中，使用谷歌的Gmail服务的SMTP服务器作为Flask-Mail配置的MAIL_SERVER。

步骤1 - 在代码中导入flask-mail模块的Mail和Message类。

from flask_mail import Mail, Message

步骤2步 - 然后根据以下设置配置Flask-Mail。

app.config['MAIL_SERVER']='smtp.gmail.com'
app.config['MAIL_PORT'] = 465
app.config['MAIL_USERNAME'] = 'yourId@gmail.com'
app.config['MAIL_PASSWORD'] = '*****'
app.config['MAIL_USE_TLS'] = False
app.config['MAIL_USE_SSL'] = True

步骤3 − 创建一个Mail类的实例。

mail = Mail(app)

步骤4 − 在由URL规则（’/’）映射的Python函数中设置一个Message对象。

@app.route("/")
def index():
   msg = Message('Hello', sender = 'yourId@gmail.com', recipients = ['id1@gmail.com'])
   msg.body = "This is the email body"
   mail.send(msg)
   return "Sent"

步骤5 - 以下是完整的代码。在Python Shell中运行以下脚本，并访问 http://localhost:5000/

from flask import Flask
from flask_mail import Mail, Message

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

app.config['MAIL_SERVER']='smtp.gmail.com'
app.config['MAIL_PORT'] = 465
app.config['MAIL_USERNAME'] = 'yourId@gmail.com'
app.config['MAIL_PASSWORD'] = '*****'
app.config['MAIL_USE_TLS'] = False
app.config['MAIL_USE_SSL'] = True
mail = Mail(app)

@app.route("/")
def index():
   msg = Message('Hello', sender = 'yourId@gmail.com', recipients = ['id1@gmail.com'])
   msg.body = "Hello Flask message sent from Flask-Mail"
   mail.send(msg)
   return "Sent"

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