```

///

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

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

## `File` 및 `Form` 매개변수 정의 { #define-file-and-form-parameters }

`Body` 및 `Query`와 동일한 방식으로 파일과 폼의 매개변수를 생성합니다:

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

파일과 폼 필드는 폼 데이터로 업로드되며, 파일과 폼 필드를 받게 됩니다.

또한 일부 파일은 `bytes`로, 일부 파일은 `UploadFile`로 선언할 수 있습니다.

## 匯入 `Field` { #import-field }

首先，你需要匯入它：

{* ../../docs_src/body_fields/tutorial001_an_py310.py hl[4] *}


/// warning

請注意，`Field` 是直接從 `pydantic` 匯入的，不像其他（如 `Query`、`Path`、`Body` 等）是從 `fastapi` 匯入。

///

## 宣告模型屬性 { #declare-model-attributes }

接著你可以在模型屬性上使用 `Field`：

{* ../../docs_src/body_fields/tutorial001_an_py310.py hl[11:14] *}

`Field` 的用法與 `Query`、`Path`、`Body` 相同，擁有相同的參數等。

/// note | 技術細節

## 範例 { #example }

以下是一個帶有參數、使用上述部分型別的 *路徑操作 (path operation)* 範例。

{* ../../docs_src/extra_data_types/tutorial001_an_py310.py hl[1,3,12:16] *}

請注意，函式內的參數會是它們的自然資料型別，因此你可以進行一般的日期運算，例如：

## 例子 { #example }

下面是一个*路径操作*的示例，其中的参数使用了上面的一些类型。

{* ../../docs_src/extra_data_types/tutorial001_an_py310.py hl[1,3,12:16] *}

注意，函数内的参数有原生的数据类型，你可以，例如，执行正常的日期操作，如:

{* ../../docs_src/path_params_numeric_validations/tutorial004_an_py310.py hl[10] *}

## Number validations: greater than and less than or equal { #number-validations-greater-than-and-less-than-or-equal }

The same applies for:

* `gt`: `g`reater `t`han
* `le`: `l`ess than or `e`qual

{* ../../docs_src/path_params_numeric_validations/tutorial005_an_py310.py hl[10] *}

## 匯入 `Cookie` { #import-cookie }

先匯入 `Cookie`：

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

## 宣告 `Cookie` 參數 { #declare-cookie-parameters }

然後用與 `Path`、`Query` 相同的結構宣告 `Cookie` 參數。

你可以設定預設值，以及所有額外的驗證或註解參數：

{* ../../docs_src/cookie_params/tutorial001_an_py310.py hl[9] *}

/// note | 技術細節

`Cookie` 是 `Path` 與 `Query` 的「姊妹」類別。它同樣繼承自共同的 `Param` 類別。

```

///

## 匯入 `Form` { #import-form }

從 `fastapi` 匯入 `Form`：

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

## 定義 `Form` 參數 { #define-form-parameters }

以與 `Body` 或 `Query` 相同的方式建立表單參數：

{* ../../docs_src/request_forms/tutorial001_an_py310.py hl[9] *}

例如，在 OAuth2 規範的一種用法（稱為「password flow」）中，必須以表單欄位傳送 `username` 與 `password`。

같은 접근 방식을 사용해 예외 핸들러에서 요청 바디에 접근할 수도 있습니다.

필요한 것은 `try`/`except` 블록 안에서 요청을 처리하는 것뿐입니다:

{* ../../docs_src/custom_request_and_route/tutorial002_an_py310.py hl[14,16] *}

예외가 발생하더라도 `Request` 인스턴스는 여전히 스코프 안에 남아 있으므로, 오류를 처리할 때 요청 바디를 읽고 활용할 수 있습니다:

{* ../../docs_src/custom_request_and_route/tutorial002_an_py310.py hl[17:19] *}

## 라우터에서의 커스텀 `APIRoute` 클래스 { #custom-apiroute-class-in-a-router }

{* ../../docs_src/body_fields/tutorial001_an_py310.py hl[4] *}


/// warning

Notice that `Field` is imported directly from `pydantic`, not from `fastapi` as are all the rest (`Query`, `Path`, `Body`, etc).

///

## Declare model attributes { #declare-model-attributes }

You can then use `Field` with model attributes:

{* ../../docs_src/body_fields/tutorial001_an_py310.py hl[11:14] *}

## 어떻게 보이는지 { #how-it-looks }

먼저 코드를 그냥 사용해서 어떻게 동작하는지 보고, 그다음에 무슨 일이 일어나는지 이해하러 다시 돌아오겠습니다.

## `main.py` 만들기 { #create-main-py }

예제를 파일 `main.py`에 복사하세요:

{* ../../docs_src/security/tutorial001_an_py310.py *}

## 실행하기 { #run-it }

/// info | 정보

[`python-multipart`](https://github.com/Kludex/python-multipart) 패키지는 `pip install "fastapi[standard]"` 명령을 실행하면 **FastAPI**와 함께 자동으로 설치됩니다.