# 第4章 · 与用户交互

对应教材第 4 章：GET / POST 取参、表单校验、CSRF、文件上传、富文本编辑器。

三件事贯穿全章：

1. 数据怎么进来 —— `request.args`（GET）vs `request.form`（POST）
2. 进来的数据怎么验 —— Flask-WTF 声明式校验 + CSRF 防护
3. 文件怎么安全地落盘 —— 白名单 + `secure_filename` + UUID 重命名

---

## 运行

```bat
cd ch04\ch4
..\..\..\venv\Scripts\python.exe app.py
```

首页 <http://127.0.0.1:5101/>，三张卡片对应三节。

---

## 文件

| 文件 | 作用 |
|---|---|
| `app.py` | 全部路由 + 两个表单类（`UploadForm` / `PostForm`） |
| `templates/basic.html` | 4.1 GET vs POST 对照实验 |
| `templates/upload.html` | 4.2 上传表单 + 校验失败信息 + 文件名对照表 |
| `templates/files.html` | 已上传文件清单 |
| `templates/post.html` | 4.3 CKEditor 富文本编辑与保存 |
| `uploads/` | 上传文件实际存放目录（自动创建） |

---

## 4.1 GET 和 POST 的数据放在哪

同一个路由 `/basic` 同时接 `GET` 和 `POST`，页面上并排放两个表单。

| | GET | POST |
|---|---|---|
| 数据位置 | URL 问号后面 `?kw=Flask&page=2` | 请求体（body）里 |
| 服务器怎么取 | `request.args.get('kw')` | `request.form.get('username')` |
| 地址栏 | 会变，能看到 | 不变，看不到 |
| 能否收藏 / 分享 | 能 | 不能 |
| 长度限制 | 受 URL 长度限制（约 2KB） | 基本无限制 |
| 典型用途 | 搜索、筛选、翻页 | 注册、登录、改密码、上传 |

页面底部有一张实时表格，把 `request.args`、`request.form`、`request.values` 三个字典都打出来。
点一次 GET 提交、点一次 POST 提交，对比着看最清楚。

---

## 4.2 安全文件上传

### 三道校验写在表单类里

```python
class UploadForm(FlaskForm):
    file = FileField('选择文件', validators=[
        FileRequired(message='请先选择一个文件'),        # 必选
        FileAllowed(ALLOWED_EXT, message='只允许...'),   # 扩展名白名单
        FileSize(max_size=2 * 1024 * 1024, message='...'),  # 大小上限
    ])
```

`validate_on_submit()` 一次把三道全跑完，任何一道不过就返回 `False`，页面显示错误信息。

### 保存文件的三道保险

```python
safe_name = secure_filename(f.filename)      # ① 过滤掉 ../、空格、中文等危险字符
if ext not in ALLOWED_EXT: ...               # ② 白名单再查一次（别信浏览器的扩展名）
new_name = f'{uuid.uuid4().hex[:8]}_{safe_name}'  # ③ 加随机前缀，防止重名覆盖
f.save(os.path.join(UPLOAD_DIR, new_name))
```

**为什么必须 `secure_filename`？**
如果用户上传的文件名叫 `../../app.py`，不做过滤就会直接覆盖你的源码。这是最经典的路径穿越攻击。

**为什么必须重命名？**
两个人同时上传 `photo.jpg`，后一个会把前一个覆盖掉。加 UUID 前缀后每个文件都唯一。

**上传页上的对照表**会显示：原名 → 安全名 → 最终保存名 → 大小 → MIME 类型，改了哪个环节一目了然。

### 大小限制还有一道

```python
app.config['MAX_CONTENT_LENGTH'] = 2 * 1024 * 1024   # 2MB
```

这是**请求级别**的硬限制，超了 Flask 直接返回 413，连表单都进不来。
`FileSize` 是**校验级别**，能给出友好提示。两道都要有。

---

## 4.3 富文本 CKEditor

```python
class PostForm(FlaskForm):
    title = StringField('文章标题', validators=[DataRequired()])
    body = CKEditorField('正文（富文本）', validators=[DataRequired()])
```

`CKEditorField` 会把普通 `textarea` 替换成一个带工具栏的编辑器。
提交上来的 `form.body.data` 是一段**带标签的 HTML**（`<p>`、`<strong>`、`<img>` 等）。

编辑器里的“上传图片”按钮会 POST 到 `/ckupload`，后端必须按 flask-ckeditor 约定的格式回应：

```python
return upload_success(url, filename=name)                     # 成功
return jsonify({'uploaded': 0, 'error': {'message': msg}}), 400  # 失败
```

格式不对，编辑器就会弹“上传失败”，但控制台看不到原因 —— 这是最容易卡住的地方。

> ⚠️ 富文本内容存库后，渲染时**不能直接 `|safe` 输出**，必须先用 Bleach 之类的库过滤标签，
> 否则等于给攻击者开了一个 XSS 后门（第 7 章博客项目会再提一次）。

---

## 常见坑

| 现象 | 原因 | 解决 |
|---|---|---|
| `CSRF token missing` | 表单里没渲染 `{{ form.hidden_tag() }}` | 每个 FlaskForm 表单都要加这一行 |
| 上传成功但文件是 0 字节 | 先 `f.read()` 又没 `seek(0)` | 读完要 `f.seek(0)` 再 `save()`，或直接先 save |
| 中文文件名变成空 | `secure_filename` 会把中文全部去掉 | 正常现象；本项目用 UUID 做前缀，原名只做展示 |
| CKEditor 工具栏是英文/不显示 | 本地资源未就绪 | `CKEDITOR_SERVE_LOCAL = True`，首次加载稍慢 |
| 413 Request Entity Too Large | 超过 `MAX_CONTENT_LENGTH` | 改配置，或压缩图片 |
| 上传目录不存在 | 忘了建目录 | `os.makedirs(UPLOAD_DIR, exist_ok=True)` |

---

## 练习

1. 把 `MAX_CONTENT_LENGTH` 改成 512KB，上传一张 1MB 的图，看报错是 413 还是表单提示。
2. 在 `ALLOWED_EXT` 里去掉 `zip`，再传一个 zip，确认 `FileAllowed` 拦住了。
3. 给 `PostForm` 加一个 `category = SelectField('分类', choices=[('tech','技术'),('life','生活')])`，在页面上渲染。
4. 在 `/basic` 页面加一个 GET 参数 `sort`，用 `request.args.get('sort', 'asc')` 控制表格排序方向。
