萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Flask-WTF 表單完整指南:驗證、CSRF 保護、OpenID 登入實戰

為什麼選 Flask-WTF?

WTForms 提供聲明式表單定義、內建驗證器、CSRF 保護、模板自動渲染。Flask-WTF 整合 Flask 上下文,讓表單處理更符合 Flask 風格。

安裝與設定

pip install flask-wtf

# config.py
CSRF_ENABLED = True
SECRET_KEY = 'your-very-long-random-secret-key-here'  # 必須複雜、保密

定義表單類別 forms.py

from flask_wtf import FlaskForm
from wtforms import StringField, BooleanField, TextAreaField, SubmitField
from wtforms.validators import DataRequired, Length, Email, Optional

class LoginForm(FlaskForm):
    openid = StringField('OpenID', validators=[DataRequired()])
    remember_me = BooleanField('Remember Me', default=False)
    submit = SubmitField('Sign In')

class PostForm(FlaskForm):
    post = TextAreaField('說點什麼', validators=[DataRequired(), Length(min=1, max=140)])
    submit = SubmitField('發布')

class EditProfileForm(FlaskForm):
    nickname = StringField('暱稱', validators=[DataRequired(), Length(max=64)])
    about_me = TextAreaField('關於我', validators=[Optional(), Length(max=140)])
    submit = SubmitField('儲存變更')

模板渲染表單 templates/login.html

{% extends "base.html" %}
{% block content %}
<h1>Sign In</h1>
<form method="post" action="">
    {{ form.hidden_tag() }}  {# CSRF token #}
    <p>
        {{ form.openid.label }}
{{ form.openid(size=80) }}
{% for error in form.openid.errors %} <span style="color:red">[{{ error }}]</span> {% endfor %} </p> <p>{{ form.remember_me }} {{ form.remember_me.label }}</p> <p>{{ form.submit }}</p> </form> {% endblock %}

視圖函數處理表單 views.py

from flask import render_template, flash, redirect, url_for, g
from flask_login import login_user, logout_user, current_user, login_required
from app import app, db, lm, oid
from forms import LoginForm, PostForm
from models import User, ROLE_USER, ROLE_ADMIN

@app.route('/login', methods=['GET', 'POST'])
@oid.loginhandler
def login():
    if current_user.is_authenticated:
        return redirect(url_for('index'))
    form = LoginForm()
    if form.validate_on_submit():
        session['remember_me'] = form.remember_me.data
        return oid.try_login(form.openid.data, ask_for=['nickname', 'email'])
    return render_template('login.html', title='Sign In', form=form,
                           providers=app.config['OPENID_PROVIDERS'])

@app.route('/', methods=['GET', 'POST'])
@app.route('/index', methods=['GET', 'POST'])
@login_required
def index():
    form = PostForm()
    if form.validate_on_submit():
        post = Post(body=form.post.data, author=g.user)
        db.session.add(post)
        db.session.commit()
        flash('貼文已發布!')
        return redirect(url_for('index'))
    posts = g.user.followed_posts().all()
    return render_template('index.html', title='Home', form=form, posts=posts)

關鍵細節解析

  • form.hidden_tag():渲染 CSRF token 隱藏欄位,**開啟 CSRF 保護時必須包含**。
  • form.validate_on_submit():等同 request.method == 'POST' and form.validate()。
  • form.field.errors:驗證失敗時的錯誤訊息列表,模板中迭代顯示。
  • redirect(url_for(...)) 後導向 GET:**PRG 模式**防止重新整理重複提交。

OpenID 登入回調

@oid.after_login
def after_login(resp):
    if not resp.email:
        flash('無效登入')
        return redirect(url_for('login'))
    
    user = User.query.filter_by(email=resp.email).first()
    if not user:
        nickname = resp.nickname or resp.email.split('@')[0]
        user = User(nickname=nickname, email=resp.email, role=ROLE_USER)
        db.session.add(user)
        db.session.commit()
    
    login_user(user, remember=session.pop('remember_me', False))
    return redirect(url_for('index'))

結語

Flask-WTF 讓表單處理「聲明式定義、自動驗證、安全防護、模板友善」四位一體。掌握 FlaskForm、驗證器、CSRF、PRG 模式,即可構建健壯的使用者互動介面。

copyright © 萬盛學電腦網 all rights reserved