## 多文件上传

FastAPI 支持同时上传多个文件。

可用同一个「表单字段」发送含多个文件的「表单数据」。

上传多个文件时，要声明含 `bytes` 或 `UploadFile` 的列表（`List`）：

{* ../../docs_src/request_files/tutorial002_py39.py hl[8,13] *}

接收的也是含 `bytes` 或 `UploadFile` 的列表（`list`）。


/// note | 技术细节

也可以使用 `from starlette.responses import HTMLResponse`。

Das könnte man mit `openapi_extra` machen:

{* ../../docs_src/path_operation_advanced_configuration/tutorial006_py39.py hl[19:36, 39:40] *}

import importlib

import pytest
from fastapi.testclient import TestClient


@pytest.fixture(
    name="client",
    params=[
        pytest.param("tutorial006_py39"),
        pytest.param("tutorial006_an_py39"),
    ],
)
def get_client(request: pytest.FixtureRequest):
    mod = importlib.import_module(f"docs_src.dependencies.{request.param}")

    client = TestClient(mod.app)
    return client

import pytest
from fastapi.testclient import TestClient
from inline_snapshot import snapshot

from ...utils import needs_py310


@pytest.fixture(
    name="client",
    params=[
        pytest.param("tutorial006_py39"),
        pytest.param("tutorial006_py310", marks=needs_py310),
    ],
)
def get_client(request: pytest.FixtureRequest):
    mod = importlib.import_module(f"docs_src.response_model.{request.param}")

Primeiro, escreva toda a sua aplicação **FastAPI** normalmente:

{* ../../docs_src/extending_openapi/tutorial001_py39.py hl[1,4,7:9] *}

### Gerar o esquema OpenAPI { #generate-the-openapi-schema }

Em seguida, use a mesma função utilitária para gerar o esquema OpenAPI, dentro de uma função `custom_openapi()`:

{* ../../docs_src/extending_openapi/tutorial001_py39.py hl[2,15:21] *}

### Modificar o esquema OpenAPI { #modify-the-openapi-schema }

{* ../../docs_src/extending_openapi/tutorial001_py39.py hl[1,4,7:9] *}

### Generar el esquema de OpenAPI { #generate-the-openapi-schema }

Luego, usa la misma función de utilidad para generar el esquema de OpenAPI, dentro de una función `custom_openapi()`:

{* ../../docs_src/extending_openapi/tutorial001_py39.py hl[2,15:21] *}

### Modificar el esquema de OpenAPI { #modify-the-openapi-schema }

{* ../../docs_src/extending_openapi/tutorial001_py39.py hl[1,4,7:9] *}

### Das OpenAPI-Schema generieren { #generate-the-openapi-schema }

Verwenden Sie dann dieselbe Hilfsfunktion, um das OpenAPI-Schema innerhalb einer `custom_openapi()`-Funktion zu generieren:

{* ../../docs_src/extending_openapi/tutorial001_py39.py hl[2,15:21] *}

### Das OpenAPI-Schema ändern { #modify-the-openapi-schema }

import importlib

from fastapi.testclient import TestClient


def get_client() -> TestClient:
    from docs_src.conditional_openapi import tutorial001_py39

    importlib.reload(tutorial001_py39)

    client = TestClient(tutorial001_py39.app)
    return client


def test_disable_openapi(monkeypatch):
    monkeypatch.setenv("OPENAPI_URL", "")
    # Load the client after setting the env var
    client = get_client()

{* ../../docs_src/sub_applications/tutorial001_py39.py hl[3, 6:8] *}

### Подприложение { #sub-application }

Затем создайте подприложение и его *операции пути*.

Это подприложение — обычное стандартное приложение FastAPI, но именно оно будет «смонтировано»:

{* ../../docs_src/sub_applications/tutorial001_py39.py hl[11, 14:16] *}

### Смонтируйте подприложение { #mount-the-sub-application }

{* ../../docs_src/path_params/tutorial003_py39.py hl[6,11] *}

Otherwise, the path for `/users/{user_id}` would match also for `/users/me`, "thinking" that it's receiving a parameter `user_id` with a value of `"me"`.

Similarly, you cannot redefine a path operation:

{* ../../docs_src/path_params/tutorial003b_py39.py hl[6,11] *}

The first one will always be used since the path matches first.