Flask-Mailman 使用指南

2025-04-17 00:24:14作者：房伟宁

1. 项目介绍

Flask-Mailman 是一个Flask扩展，提供了简单的邮件发送功能。它旨在替代未维护的 Flask-Mail，并提供更好的保障和更多功能。Flask-Mailman 将 Django 的邮件实现移植到了 Flask 应用程序中，可能是目前Python中最佳的可用的邮件发送实现。

2. 项目快速启动

首先，确保你已经安装了 Flask。接下来，你可以通过以下步骤快速启动 Flask-Mailman。

from flask import Flask
from flask_mailman import Mail

app = Flask(__name__)
app.config['MAIL_SERVER'] = 'smtp.example.com'
app.config['MAIL_PORT'] = 587
app.config['MAIL_USE_TLS'] = True
app.config['MAIL_USERNAME'] = 'your-email@example.com'
app.config['MAIL_PASSWORD'] = 'your-password'

mail = Mail(app)

@app.route('/')
def index():
    mail.send_message(
        'Subject here',
        sender='your-email@example.com',
        recipients=['example@example.com'],
        body='This is the email body'
    )
    return 'Email sent!'

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

确保替换上述代码中的配置信息，以匹配你的SMTP服务提供商的设置。

3. 应用案例和最佳实践

邮件发送案例

下面的代码展示了如何使用 Flask-Mailman 发送一封简单的邮件：

from flask_mailman import Mail

mail = Mail(app)

def send_email(subject, to_list, body):
    mail.send_message(
        subject=subject,
        sender='your-email@example.com',
        recipients=to_list,
        body=body
    )

使用模板

为了发送更复杂的邮件，可以使用HTML模板。首先，创建一个HTML文件作为邮件模板，然后在发送邮件时使用这个模板。

<!-- example.html -->
<html>
<head>
    <title>邮件标题</title>
</head>
<body>
    <h1>你好！</h1>
    <p>{{ body_text }}</p>
</body>
</html>

然后在Python代码中使用这个模板：

from flask_mailman import Mail
from flask import render_template

mail = Mail(app)

def send_html_email(subject, to_list, body_text):
    html_content = render_template('example.html', body_text=body_text)
    mail.send_message(
        subject=subject,
        sender='your-email@example.com',
        recipients=to_list,
        body=html_content,
        html=True
    )