Flask 简明教程

Flask – Mail

一个基于网络的应用程序常常需要一个向用户/客户端发送邮件的功能。 Flask-Mail 扩展使得使用任何电子邮件服务器设置一个简单的接口变得非常容易。

首先，应该使用 pip 实用程序安装 Flask-Mail 扩展。

pip install Flask-Mail

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

Sr.No

Parameters & Description

1

MAIL_SERVER 电子邮件服务器的名称/IP 地址

2

MAIL_PORT 使用的服务器的端口号

3

MAIL_USE_TLS 启用/禁用传输层安全加密

4

MAIL_USE_SSL 启用/禁用安全套接字层加密

5

MAIL_DEBUG 调试支持。默认为 Flask 应用程序的调试状态

6

MAIL_USERNAME User name of sender

7

MAIL_PASSWORD password of sender

8

MAIL_DEFAULT_SENDER sets default sender

9

MAIL_MAX_EMAILS 设置要发送的最大邮件数

10

MAIL_SUPPRESS_SEND 如果 app.testing 设置为真，则发送被禁止

11

MAIL_ASCII_ATTACHMENTS 如果设置为真，则将附件的文件名转换为 ASCII

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

Mail class

它管理电子邮件消息传递的需求。该类的构造器采用以下形式 −

flask-mail.Mail(app = None)

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

Methods of Mail class

Sr.No

Methods & Description

1

send() 发送 Message 类的对象的内容

2

connect() 打开与邮件主机的连接

3

send_message() Sends message object

Message class

它封装了一封电子邮件。Message 类的构造器有几个参数 −

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

Message class methods

attach() − 向邮件添加附件。此方法采用以下参数 −

  1. filename − 附件文件的文件名

  2. content_type − 文件的 MIME 类型

  3. data − 原始文件数据

  4. disposition − 以及内容处置（如存在）

add_recipient() − 向电子邮件添加另一位收件人

在以下示例中，将 Google Gmail 服务的 SMTP 服务器用作 Flask-Mail 配置的 MAIL_SERVER。

Step 1 − 在代码中从 flask-mail 模块导入 Mail 和 Message 类。

from flask_mail import Mail, Message

Step 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

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

mail = Mail(app)

Step 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"

Step 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)

请注意，Gmail 服务中的内置安全功能可能会阻止此登录尝试。您可能需要降低安全级别。请登录您的 Gmail 帐户并访问 this 链接以降低安全性。

decrease the security