diff --git a/docs/zh/docs/tutorial/request-forms-and-files.md b/docs/zh/docs/tutorial/request-forms-and-files.md new file mode 100644 index 000000000..a27ba93d5 --- /dev/null +++ b/docs/zh/docs/tutorial/request-forms-and-files.md @@ -0,0 +1,38 @@ +# 请求表单与文件 + +FastAPI 支持同时使用 `File` 和 `Form` 定义文件和表单字段。 + +!!! info "说明" + + 接收上传文件或表单数据,要预先安装 `python-multipart`。 + + 例如,`pip install python-multipart`。 + +## 导入 `File` 与 `Form` + +```Python hl_lines="1" +{!../../../docs_src/request_forms_and_files/tutorial001.py!} +``` + +## 定义 `File` 与 `Form` 参数 + +创建文件和表单参数的方式与 `Body` 和 `Query` 一样: + +```Python hl_lines="8" +{!../../../docs_src/request_forms_and_files/tutorial001.py!} +``` + +文件和表单字段作为表单数据上传与接收。 + +声明文件可以使用 `bytes` 或 `UploadFile` 。 + +!!! warning "警告" + + 可在一个*路径操作*中声明多个 `File` 与 `Form` 参数,但不能同时声明要接收 JSON 的 `Body` 字段。因为此时请求体的编码为 `multipart/form-data`,不是 `application/json`。 + + 这不是 **FastAPI** 的问题,而是 HTTP 协议的规定。 + +## 小结 + +在同一个请求中接收数据和文件时,应同时使用 `File` 和 `Form`。 + diff --git a/docs/zh/mkdocs.yml b/docs/zh/mkdocs.yml index ed1142214..85e470e59 100644 --- a/docs/zh/mkdocs.yml +++ b/docs/zh/mkdocs.yml @@ -75,6 +75,7 @@ nav: - tutorial/cookie-params.md - tutorial/request-forms.md - tutorial/request-files.md + - tutorial/request-forms-and-files.md - tutorial/handling-errors.md - tutorial/body-updates.md - 安全性: