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.pyfrom 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.pyfrom 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 模式**防止重新整理重複提交。@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 模式,即可構建健壯的使用者互動介面。