理论课ch04配套实践:lab05_forms_and_upload(端口 5101)

第4章 与用户交互(表单与上传)

授课:谢福财 · 每个知识点按「是什么 → 生活案例 → 代码对照 → 易错点」四步讲,课后对照同章的实践课手册动手。

一、这节课要学会什么

  1. 分清 GET 与 POST 的语义
  2. 会用 Flask-WTF 定义表单并校验
  3. 理解 CSRF 是什么、为什么必须有
  4. 会做安全的文件上传

二、知识点逐个讲

1. GET 与 POST

GET 把参数放地址里,用来“取”;POST 把数据放请求体里,用来“交”。

生活案例:GET 是查快递(只看不改);POST 是寄快递(交了东西,状态变了)。
@app.route('/basic', methods=['GET','POST']) if request.method == 'POST': ...
用 GET 做删除:浏览器刷新一次删一次。

2. Flask-WTF:把校验写清楚

表单类里声明字段和校验器,提交时 form.validate_on_submit() 一把校验完,错误信息回填到模板。

生活案例:报名表:姓名必填、年龄必须是数字——表本身写着规则,收表的人不用逐条问。
class BasicForm(FlaskForm): name = StringField('姓名', validators=[DataRequired()]) score = FloatField('成绩', validators=[NumberRange(0,100)])
忘了 validators= 就永远校验不过。

3. CSRF:防“替你提交”

别人伪造一个表单让你的浏览器提交,Flask-WTF 要求表单里带一次性 token,没有就 400。

生活案例:银行取款要本人签名+身份证;token 就是这一次的签名,别人复制不走。
{{ form.csrf_token }} {# 表单里必须有 #}
删掉这一行会看到 400 The CSRF token is missing——这是保护在起作用。

4. 安全上传:三重校验

后缀白名单 + MIME 类型 + 文件大小,并且重命名后再存,避免覆盖和可执行文件。

生活案例:机场托运:先看是不是违禁品(类型),再看超没超重(大小),最后贴条码(重命名)。
fn = secure_filename(f.filename) f.save(os.path.join(UPLOAD, fn))
只查后缀不够,文件名里的 ../ 会把文件写到别的目录。

5. 富文本与文件列表

CKEditor 把 textarea 变成可视化编辑器;文件列表读出 upload 目录内容展示。

生活案例:写公众号:不用记 Markdown,点按钮加粗、插图。
{{ ckeditor.load() }}{{ ckeditor.create() }}
富文本内容存库前要过滤脚本,否则有 XSS 风险。

三、课堂演示(本机实拍)

课堂演示:打开 lab05/app.py
课堂演示:运行面板 Running on 5101,提交表单可看日志

四、课堂练习

  1. 提交一个 101 分的成绩,看校验提示
  2. 上传一个 .txt 改名为 .png,看能否通过校验
  3. 在终端里看 POST 请求的日志行,指出状态码
做完对着实践课手册第六节的报错实战自查一遍:能自己看懂红字,才算真的会。

五、小结与下一节

本节要点:分清 GET 与 POST 的语义、会用 Flask-WTF 定义表单并校验、理解 CSRF 是什么、为什么必须有。

下一节:第5章:数据存下来——SQLAlchemy 与数据库迁移