/// tip | İpucu

Environment variable'ları anlamak için [Ortam Değişkenleri](../environment-variables.md) dokümanını okuyabilirsiniz.

///

## Tipler ve doğrulama { #types-and-validation }

Bu environment variable'lar yalnızca metin (string) taşıyabilir; çünkü Python'ın dışındadırlar ve diğer programlarla ve sistemin geri kalanıyla uyumlu olmaları gerekir (hatta Linux, Windows, macOS gibi farklı işletim sistemleriyle de).

### Instalar `pydantic-settings` { #install-pydantic-settings }

Primero, asegúrate de crear tu [entorno virtual](../virtual-environments.md), actívalo y luego instala el paquete `pydantic-settings`:

<div class="termy">

```console
$ pip install pydantic-settings
---> 100%
```

</div>

Wenn Sie jedoch den Befehl `pip install fastapi` verwenden, ist das Paket `python-multipart` nicht standardmäßig enthalten.

Um es manuell zu installieren, stellen Sie sicher, dass Sie eine [virtuelle Umgebung](../../virtual-environments.md) erstellen, sie aktivieren und es dann mit:

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

installieren.

Das liegt daran, dass **OAuth2** „Formulardaten“ zum Senden von `username` und `password` verwendet.

Mais vous pouvez également installer un serveur ASGI manuellement.

Vous devez créer un [environnement virtuel](../virtual-environments.md), l'activer, puis vous pouvez installer l'application serveur.

Par exemple, pour installer Uvicorn :

<div class="termy">

```console
$ pip install "uvicorn[standard]"

---> 100%
```

</div>

## サーバープログラムをインストール { #install-the-server-program }

FastAPI をインストールすると、本番サーバーの Uvicorn が同梱されており、`fastapi run` コマンドで起動できます。

ただし、ASGI サーバーを手動でインストールすることもできます。

[仮想環境](../virtual-environments.md)を作成して有効化し、サーバーアプリケーションをインストールしてください。

例として、Uvicorn をインストールするには:

<div class="termy">

```console
$ pip install "uvicorn[standard]"

---> 100%
```

</div>

他の ASGI サーバープログラムでも同様の手順です。

Однак, якщо ви використовуєте команду `pip install fastapi`, пакет `python-multipart` за замовчуванням не включено.

Щоб встановити його вручну, переконайтеся, що ви створили [віртуальне оточення](../../virtual-environments.md), активували його, а потім встановили:

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

Це тому, що **OAuth2** використовує «form data» для надсилання `username` та `password`.

///

當你使用 `pip install "fastapi[standard]"` 指令安裝時，[`python-multipart`](https://github.com/Kludex/python-multipart) 套件會隨 FastAPI 自動安裝。

不過若只執行 `pip install fastapi`，預設不會包含 `python-multipart`。

若要手動安裝，請先建立並啟用一個[虛擬環境](../../virtual-environments.md)，接著執行：

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

因為 OAuth2 會以「form data」傳送 `username` 與 `password`。

///

用以下指令執行範例：

<div class="termy">

```console
$ fastapi dev

当你使用命令 `pip install "fastapi[standard]"` 安装 **FastAPI** 时，[`python-multipart`](https://github.com/Kludex/python-multipart) 包会自动安装。

但是，如果你使用 `pip install fastapi`，默认不会包含 `python-multipart` 包。

如需手动安装，请先创建并激活[虚拟环境](../../virtual-environments.md)，然后执行：

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

这是因为 **OAuth2** 使用“表单数据”来发送 `username` 和 `password`。

///

用下面的命令运行示例：

<div class="termy">

```console
$ fastapi dev

# 설정과 환경 변수 { #settings-and-environment-variables }

많은 경우 애플리케이션에는 외부 설정이나 구성(예: secret key, 데이터베이스 자격 증명, 이메일 서비스 자격 증명 등)이 필요할 수 있습니다.

이러한 설정 대부분은 데이터베이스 URL처럼 변동 가능(변경될 수 있음)합니다. 그리고 많은 설정은 secret처럼 민감할 수 있습니다.

이 때문에 보통 애플리케이션이 읽어들이는 환경 변수로 이를 제공하는 것이 일반적입니다.

/// tip | 팁

환경 변수를 이해하려면 [환경 변수](../environment-variables.md)를 읽어보세요.

///

## 타입과 검증 { #types-and-validation }

# 設定與環境變數 { #settings-and-environment-variables }

在許多情況下，你的應用程式可能需要一些外部設定或組態，例如密鑰、資料庫憑證、電子郵件服務的憑證等。

這些設定大多是可變的（可能會改變），像是資料庫 URL。也有許多可能是敏感資訊，例如密鑰。

因此，通常會透過環境變數提供這些設定，讓應用程式去讀取。

/// tip

若想了解環境變數，你可以閱讀[環境變數](../environment-variables.md)。

///

## 型別與驗證 { #types-and-validation }

這些環境變數只能處理文字字串，因為它們在 Python 之外，必須與其他程式與系統的其餘部分相容（甚至跨作業系統，如 Linux、Windows、macOS）。

這表示在 Python 中自環境變數讀取到的任何值都會是 `str`，而任何轉型成其他型別或驗證都必須在程式碼中完成。