Flask 表单处理方法（含源码）

Flask中表单处理是非常重要的一个功能。在这篇文章中，我们将会讲解如何使用Flask来处理表单。在我们开始之前，假定您已经熟悉Flask的基础知识，如创建应用程序、路由、模板等。

我们将会分为以下几个步骤介绍如何完成整个表单处理过程:

创建HTML表单

首先，我们需要在HTML页面上创建一个表单。表单需要有一个action，method和一个提交按钮。下面是一个简单的表单示例：

<!DOCTYPE html>
<html>
<head>
    <title>Flask Form Example</title>
</head>
<body>
    <h1>Flask Form Example</h1>
    <form method="POST" action="{{ url_for('submit_form') }}">
        <label for="name">Name:</label>
        <input type="text" id="name" name="name"><br><br>
        <label for="email">Email:</label>
        <input type="email" id="email" name="email"><br><br>
        <label for="message">Message:</label>
        <textarea id="message" name="message"></textarea><br><br>
        <input type="submit" value="Submit">
    </form>
</body>
</html>

这是一个简单的表单，需要用户输入姓名、电子邮件和消息，并且提交表单。

创建Flask视图函数

现在，我们需要在我们的Flask应用程序中创建一个视图函数来处理表单数据。我们需要在视图函数中完成以下操作：

检查请求方法是否为POST
从请求中获取表单数据
检查表单数据是否有效
将数据存储到数据库中，或者发送电子邮件并进行其他操作
返回结果给用户

以下是一个简单的示例代码，演示如何创建Flask视图函数来处理表单数据：

from flask import Flask, request, render_template

app = Flask(__name__)

@app.route('/')
def home():
    return render_template('home.html')

@app.route('/submit_form', methods=['POST'])
def submit_form():
    name = request.form['name']
    email = request.form['email']
    message = request.form['message']

    # validate form data
    if not name or not email or not message:
        return "All form fields are required."

    # store data in database, send email, etc.

    return "Form submitted successfully."

编写表单验证代码

在上面的代码中，我们需要验证表单数据以确保它们是有效的。这是保证输入数据质量的重要步骤。

表单验证包括以下几个方面：

验证必填字段
验证电子邮件格式是否正确
验证输入是否符合特定格式的要求(如输入只能为数字或大小写字母，或者最小长度或最大长度)
自定义验证规则

以下是一个简单的Flask-WTF的自定义验证代码示例，它验证电子邮件地址是否重复:

from wtforms import Form, StringField, TextAreaField, validators
from flask_wtf import FlaskForm
from app.models import User

class ContactForm(FlaskForm):
    name = StringField('Name', [validators.DataRequired()])
    email = StringField('Email', [
        validators.DataRequired(),
        validators.Email(),
        validators.Optional(strip_whitespace=True),
        validators.NoneOf(User.query.with_entities(User.email).all(), message="Email already exists")
    ])
    message = TextAreaField('Message', [validators.DataRequired()])

    def validate(self):
        if not FlaskForm.validate(self):
            return False

        if User.query.filter_by(email=self.email.data).first():
            self.email.errors.append("Email already exists")
            return False

        return True

上述代码中，我们定义了一个继承自WTForms的类，它定义了三个字段:name,email,message，每个字段都具有各自的验证规则。在这个示例中，我们使用了自定义的验证规则来检查电子邮件地址是否已经存在于数据库中的用户表中。如果电子邮件地址已经存在，则验证将失败。

将数据存储到数据库中

在Flask应用程序中存储数据的方法有很多，例如使用ORM,Peewee或SQLAlchemy等。

在以下示例中，我们使用SQLAlchemy将表单数据存储到MySQL中：

from flask_sqlalchemy import SQLAlchemy
from app.models import Contact

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://{user}:{password}@{host}/{database}?charset=utf8mb4'.format(
    user='root',
    password='root123',
    host='localhost',
    database='flask_form_example'
)
db = SQLAlchemy(app)

class ContactForm(FlaskForm):
    name = StringField('Name', [validators.DataRequired()])
    email = StringField('Email', [
        validators.DataRequired(),
        validators.Email(),
        validators.Optional(strip_whitespace=True),
        validators.NoneOf(User.query.with_entities(User.email).all(), message="Email already exists")
    ])
    message = TextAreaField('Message', [validators.DataRequired()])

    def validate(self):
        if not FlaskForm.validate(self):
            return False

        if User.query.filter_by(email=self.email.data).first():
            self.email.errors.append("Email already exists")
            return False

        return True

@app.route('/submit_form', methods=['POST'])
def submit_form():
    form = ContactForm(request.form)

    if form.validate():
        name = form.name.data
        email = form.email.data
        message = form.message.data

        # save data in database
        contact = Contact(name=name, email=email, message=message)
        db.session.add(contact)
        db.session.commit()

        return "Form submitted successfully."
    else:
        return render_template('home.html', form=form)

在上述代码中，我们使用了Flask SQLalchemy插件来将表单数据存储到数据库。我们首先定义了一个Contact模型，它代表了在联系表中存储的数据。然后，我们在submit_form视图函数中使用模型来将表单存储到数据库中。

返回表单处理结果给用户

在最后一步，我们需要向用户返回表单提交结果。在这个步骤中，我们可以根据实际需要渲染不同的响应消息、重定向用户到另外的页面或者直接返回JSON数据等。

以下是最简单的表单处理完成后，在返回结果时向用户展示文字消息的代码：

@app.route('/submit_form', methods=['POST'])
def submit_form():
    name = request.form['name']
    email = request.form['email']
    message = request.form['message']

    # validate form data
    if not name or not email or not message:
        return "All form fields are required."

    # store data in database, send email, etc.

    return "Form submitted successfully."

这个例子中，我们对表单数据进行了必填字段验证，如果表单数据不符合要求，我们直接向用户返回"All form fields are required."这条文本消息。如果表单数据验证通过，我们就返回一个简单的"Form submitted successfully."消息。