# 폼 및 파일 요청 { #request-forms-and-files }

`File` 과 `Form` 을 사용하여 파일과 폼 필드를 동시에 정의할 수 있습니다.

/// info

업로드된 파일 및/또는 폼 데이터를 받으려면 먼저 [`python-multipart`](https://github.com/Kludex/python-multipart)를 설치해야 합니다.

[가상 환경](../virtual-environments.md)을 생성하고, 활성화한 다음 설치해야 합니다. 예:

```console
$ pip install python-multipart
```

///

## `File` 및 `Form` 임포트 { #import-file-and-form }

```console
$ pip install python-multipart
```

///

## `File` ve `Form` Import Edin { #import-file-and-form }

{* ../../docs_src/request_forms_and_files/tutorial001_an_py310.py hl[3] *}

## `File` ve `Form` Parametrelerini Tanımlayın { #define-file-and-form-parameters }

Dosya ve form parametrelerini, `Body` veya `Query` için yaptığınız şekilde oluşturun:

{* ../../docs_src/request_forms_and_files/tutorial001_an_py310.py hl[10:12] *}

///

## Pydantic Models for Forms { #pydantic-models-for-forms }

You just need to declare a **Pydantic model** with the fields you want to receive as **form fields**, and then declare the parameter as `Form`:

{* ../../docs_src/request_form_models/tutorial001_an_py310.py hl[9:11,15] *}

**FastAPI** will **extract** the data for **each field** from the **form data** in the request and give you the Pydantic model you defined.

```console
$ pip install python-multipart
```

///

## `File` und `Form` importieren { #import-file-and-form }

{* ../../docs_src/request_forms_and_files/tutorial001_an_py310.py hl[3] *}

## `File` und `Form`-Parameter definieren { #define-file-and-form-parameters }

Erstellen Sie Datei- und Formularparameter, so wie Sie es auch mit `Body` oder `Query` machen würden:

# 请求表单与文件 { #request-forms-and-files }

FastAPI 支持同时使用 `File` 和 `Form` 定义文件和表单字段。

/// info | 信息

接收上传的文件和/或表单数据，首先安装 [`python-multipart`](https://github.com/Kludex/python-multipart)。

请先创建并激活一个[虚拟环境](../virtual-environments.md)，然后再安装，例如：

```console
$ pip install python-multipart
```

///

## 导入 `File` 与 `Form` { #import-file-and-form }

{* ../../docs_src/request_forms_and_files/tutorial001_an_py310.py hl[3] *}

# 請求中的表單與檔案 { #request-forms-and-files }

你可以使用 `File` 與 `Form` 同時定義檔案與表單欄位。

/// info

要接收上傳的檔案與/或表單資料，請先安裝 [`python-multipart`](https://github.com/Kludex/python-multipart)。

請先建立並啟用一個 [虛擬環境](../virtual-environments.md)，然後再安裝，例如：

```console
$ pip install python-multipart
```

///

## 匯入 `File` 與 `Form` { #import-file-and-form }

{* ../../docs_src/request_forms_and_files/tutorial001_an_py310.py hl[3] *}

# リクエストフォームとファイル { #request-forms-and-files }

`File`と`Form`を同時に使うことでファイルとフォームフィールドを定義することができます。

/// info | 情報

アップロードされたファイルやフォームデータを受信するには、まず[`python-multipart`](https://github.com/Kludex/python-multipart)をインストールします。

[仮想環境](../virtual-environments.md)を作成し、それを有効化してから、例えば次のようにインストールしてください:

```console
$ pip install python-multipart
```

///

## `File`と`Form`のインポート { #import-file-and-form }

# Run manually to reformat a file:
# clang-format -i --style=file <file>
BasedOnStyle: Google

{* ../../docs_src/request_form_models/tutorial001_an_py310.py hl[9:11,15] *}

**FastAPI**는 요청에서 받은 **폼 데이터**에서 **각 필드**에 대한 데이터를 **추출**하고 정의한 Pydantic 모델을 줍니다.

## 문서 확인하기 { #check-the-docs }

문서 UI `/docs`에서 확인할 수 있습니다:

<div class="screenshot">
<img src="/img/tutorial/request-form-models/image01.png">
</div>

## 추가 폼 필드 금지하기 { #forbid-extra-form-fields }

///

## Form'lar için Pydantic Model'leri { #pydantic-models-for-forms }

Sadece, **form field** olarak almak istediğiniz alanlarla bir **Pydantic model** tanımlayın ve ardından parametreyi `Form` olarak bildirin:

{* ../../docs_src/request_form_models/tutorial001_an_py310.py hl[9:11,15] *}

**FastAPI**, request içindeki **form data**'dan **her bir field** için veriyi **çıkarır** ve size tanımladığınız Pydantic model'ini verir.