**Flask-Mail** 是一个流行的 Flask 应用扩展，它简化了在 Flask 框架中发送电子邮件的过程。通过 Flask-Mail，你可以轻松地集成 SMTP 服务，以在应用程序触发特定事件时向用户发送通知。下面将详细介绍 Flask-Mail 的安装、配置参数以及基本使用技巧。
### 安装 Flask-Mail
要安装 Flask-Mail，你可以使用 Python 的包管理器 pip。在命令行中运行以下命令：
```bash
pip3 install flask-mail
```
### 配置 Flask-Mail
在使用 Flask-Mail 之前，需要先进行配置。配置通常是通过设置 Flask 应用的配置字典来完成的。以下是一些常见的配置参数及其说明：
- **MAIL_SERVER**: 电子邮件服务器的主机名或 IP 地址。
- **MAIL_PORT**: 电子邮件服务器的端口号，通常为 25（非加密）或 465（SSL 加密）。
- **MAIL_USE_TLS**: 如果设置为 `True`，启用传输层安全协议（TLS）。
- **MAIL_USE_SSL**: 如果设置为 `True`，启用安全套接层协议（SSL）。
- **MAIL_USERNAME**: 邮件账户的用户名。
- **MAIL_PASSWORD**: 邮件账户的密码。对于某些服务商，如网易 163 邮箱，需要使用客户端授权密码，而不是常规登录密码。
例如，以下是一个使用网易 163 邮箱的配置示例：
```python
app.config["MAIL_SERVER"] = "smtp.163.com"
app.config["MAIL_PORT"] = 465
app.config["MAIL_USE_SSL"] = True
app.config["MAIL_USERNAME"] = "[email protected]"
app.config["MAIL_PASSWORD"] = "123456"
```
### 使用 Flask-Mail
创建一个 Flask 应用实例后，你需要初始化 Flask-Mail 实例：
```python
from flask_mail import Mail
mail = Mail(app)
```
发送邮件的函数通常使用异步方式执行，以避免阻塞应用程序的主线程。下面是一个简单的示例，展示了如何创建邮件并发送：
```python
from flask import Flask, request
from flask_mail import Message
from threading import Thread
@app.route("/send_mail")
def send_mail():
# 创建邮件消息
message = Message("邮件标题", sender=app.config["MAIL_USERNAME"], recipients=["[email protected]"])
message.body = "邮件内容"
# 异步发送邮件
t = Thread(target=send_email, args=(message,))
t.start()
return "发送成功"
def send_email(msg):
with app.app_context():
mail.send(msg)
```
在这个例子中，`send_email` 函数用于发送邮件，它会在一个新线程中运行。`with app.app_context():` 语句确保在发送邮件时有正确的 Flask 上下文。
### 邮件消息结构
`Message` 类是 Flask-Mail 中的核心类，用于构建电子邮件。你需要指定邮件的标题、发送者和接收者。接收者可以是一个或多个电子邮件地址的列表。邮件正文可以通过 `body` 属性设置，支持纯文本。如果需要发送 HTML 邮件，可以使用 `html` 属性。
```python
message = Message("邮件标题", sender="[email protected]", recipients=["[email protected]"])
message.body = "纯文本内容"
message.html = "<p>HTML 内容</p>"
```
### 结论
Flask-Mail 提供了一种简单且灵活的方式来集成电子邮件服务到 Flask 应用中。通过配置 SMTP 服务器信息，设置发件人和收件人，以及创建邮件内容，你可以在你的应用中实现自动化邮件发送功能。无论是用于通知、验证还是其他目的，Flask-Mail 都是一个强大的工具，可以帮助开发者轻松地与用户进行通信。
