Python库flask-mail详细介绍

Flask-Mail是一个用于发送电子邮件的Python库，特别为Flask Web框架设计，但也可以在其他项目中独立使用。它提供了一层简单的API来处理电子邮件的发送任务，包括文本邮件、HTML邮件、附件等。下面是Flask-Mail库的一些核心特性和使用方法的详细介绍：

安装

首先，你需要安装Flask-Mail库，可以通过pip来完成：

pip install Flask-Mail

基本使用

在使用Flask-Mail之前，你需要配置它。通常，这在Flask应用的配置阶段完成：

from flask import Flask
from flask_mail import Mail, Message

app = Flask(__name__)
app.config['MAIL_SERVER'] = 'your.mail.server'
app.config['MAIL_PORT'] = 587  # 587或25、465，取决于服务器设置
app.config['MAIL_USE_TLS'] = True  # 如果服务器支持TLS，设置为True，端口号587或25
app.config['MAIL_USE_SSL'] = True  # 如果服务器支持SSL，设置为True，端口后465
app.config['MAIL_USERNAME'] = 'your-email@example.com'
app.config['MAIL_PASSWORD'] = 'your-password'

mail = Mail(app)

发送邮件

配置完成后，你可以使用Mail实例来发送邮件。以下是一个发送简单文本邮件的例子：

@app.route('/send_email')
def send_email():
    msg = Message('Hello from Flask-Mail',
                  sender='your-email@example.com',
                  recipients=['recipient@example.com'])
    msg.body = "This is a test email sent from Flask-Mail."

    mail.send(msg)

    return "Email sent!"

发送HTML邮件与附件

Flask-Mail也支持发送HTML格式的邮件及带有附件的邮件：

from flask_mail import Message

@app.route('/send_html_email')
def send_html_email():
    msg = Message('HTML Email Example',
                  sender='your-email@example.com',
                  recipients=['recipient@example.com'])
    msg.html = "<p>This is an <strong>HTML</strong> formatted email.</p>"

    with app.open_resource('path/to/file.pdf') as attachment:
        msg.attach('file.pdf', 'application/pdf', attachment.read(), 'attachment')

    mail.send(msg)

    return "HTML email with attachment sent!"

在这个例子中，我们不仅设置了邮件的HTML内容，还附加了一个PDF文件作为附件。

高级配置与使用

Flask-Mail还支持更多高级配置，比如设置默认的邮件“发件人”、使用SMTP认证方法等。此外，你还可以自定义邮件的回复地址、抄送（CC）、密送（BCC）等邮件头信息。

总结

Flask-Mail为Flask应用提供了简单而强大的邮件发送功能，无论是日常的通知邮件、密码重置链接还是复杂的HTML邮件和附件发送，都能轻松应对。通过灵活的配置和直观的API，开发者可以快速集成邮件发送功能到他们的Web应用中。