Flask 中如何使用 WTForms 进行表单验证？

推荐答案

在 Flask 中使用 WTForms 进行表单验证的步骤如下：

1. 安装 WTForms： 首先需要安装 WTForms 和 Flask-WTF 扩展：

   pip install WTForms Flask-WTF

2. 创建表单类： 使用 WTForms 创建一个表单类，定义表单字段和验证规则：

   // www.javascriptcn.com code example
   from flask_wtf import FlaskForm
   from wtforms import StringField, PasswordField, SubmitField
   from wtforms.validators import DataRequired, Length, Email
   
   class RegistrationForm(FlaskForm):
       username = StringField('Username', validators=[DataRequired(), Length(min=4, max=25)])
       email = StringField('Email', validators=[DataRequired(), Email()])
       password = PasswordField('Password', validators=[DataRequired(), Length(min=6)])
       submit = SubmitField('Register')

3. 在视图函数中使用表单： 在 Flask 视图函数中实例化表单类，并处理表单提交：

   // www.javascriptcn.com code example
   from flask import Flask, render_template, redirect, url_for, flash
   from forms import RegistrationForm
   
   app = Flask(__name__)
   app.config['SECRET_KEY'] = 'your_secret_key'
   
   @app.route('/register', methods=['GET', 'POST'])
   def register():
       form = RegistrationForm()
       if form.validate_on_submit():
           # 处理表单数据
           flash(f'Account created for {form.username.data}!', 'success')
           return redirect(url_for('home'))
       return render_template('register.html', form=form)

4. 在模板中渲染表单： 在 HTML 模板中使用 Jinja2 渲染表单：

   // www.javascriptcn.com code example
   <form method="POST" action="">
       {{ form.hidden_tag() }}
       <div>
           {{ form.username.label }}<br>
           {{ form.username(size=32) }}<br>
           {% for error in form.username.errors %}
               <span style="color: red;">[{{ error }}]</span>
           {% endfor %}
       </div>
       <div>
           {{ form.email.label }}<br>
           {{ form.email(size=32) }}<br>
           {% for error in form.email.errors %}
               <span style="color: red;">[{{ error }}]</span>
           {% endfor %}
       </div>
       <div>
           {{ form.password.label }}<br>
           {{ form.password(size=32) }}<br>
           {% for error in form.password.errors %}
               <span style="color: red;">[{{ error }}]</span>
           {% endfor %}
       </div>
       <div>
           {{ form.submit() }}
       </div>
   </form>

本题详细解读

WTForms 简介

WTForms 是一个灵活的表单处理和验证库，适用于 Python Web 应用程序。它与 Flask 集成良好，通过 Flask-WTF 扩展可以更方便地在 Flask 中使用 WTForms。

表单验证流程

1. 表单类定义：

   • 表单类继承自 FlaskForm，每个字段都是一个 Field 类的实例。
   • 字段可以附加多个验证器（validators），如 DataRequired、Length、Email 等，用于验证用户输入。

2. 视图函数处理：

   • 在视图函数中实例化表单类。
   • 使用 form.validate_on_submit() 方法检查表单是否提交并通过验证。
   • 如果验证通过，可以处理表单数据并重定向到其他页面。

3. 模板渲染：

   • 使用 Jinja2 模板引擎渲染表单字段。
   • form.hidden_tag() 用于生成隐藏的 CSRF 令牌字段，防止跨站请求伪造攻击。
   • 可以通过 form.field_name.errors 获取字段的验证错误信息，并在模板中显示。

常见验证器

• DataRequired：确保字段不为空。
• Length：限制字段的长度范围。
• Email：验证字段是否为有效的电子邮件地址。
• EqualTo：验证两个字段的值是否相等（常用于密码确认）。

安全性

• Flask-WTF 自动处理 CSRF 保护，确保表单提交的安全性。
• 通过 app.config['SECRET_KEY'] 设置密钥，用于加密 CSRF 令牌。

通过以上步骤，可以在 Flask 中轻松使用 WTForms 进行表单验证，确保用户输入的数据符合预期。