tiangolo.fastapi/docs/em/docs/tutorial/request-files.md

📨 📁

👆 💪 🔬 📁 📂 👩‍💻 ⚙️ File.

!!! info 📨 📂 📁, 🥇 ❎ python-multipart.

🤶 Ⓜ. `pip install python-multipart`.

👉 ↩️ 📂 📁 📨 "📨 💽".

🗄 File

🗄 File & UploadFile ⚪️➡️ fastapi:

{!../../../docs_src/request_files/tutorial001.py!}

🔬 File 🔢

✍ 📁 🔢 🎏 🌌 👆 🔜 Body ⚖️ Form:

{!../../../docs_src/request_files/tutorial001.py!}

!!! info File 🎓 👈 😖 🔗 ⚪️➡️ Form.

✋️ 💭 👈 🕐❔ 👆 🗄 `Query`, `Path`, `File` & 🎏 ⚪️➡️ `fastapi`, 👈 🤙 🔢 👈 📨 🎁 🎓.

!!! tip 📣 📁 💪, 👆 💪 ⚙️ File, ↩️ ⏪ 🔢 🔜 🔬 🔢 🔢 ⚖️ 💪 (🎻) 🔢.

📁 🔜 📂 "📨 💽".

🚥 👆 📣 🆎 👆 ➡ 🛠️ 🔢 🔢 bytes, FastAPI 🔜 ✍ 📁 👆 & 👆 🔜 📨 🎚 bytes.

✔️ 🤯 👈 👉 ⛓ 👈 🎂 🎚 🔜 🏪 💾. 👉 🔜 👷 👍 🤪 📁.

✋️ 📤 📚 💼 ❔ 👆 💪 💰 ⚪️➡️ ⚙️ UploadFile.

📁 🔢 ⏮️ UploadFile

🔬 📁 🔢 ⏮️ 🆎 UploadFile:

{!../../../docs_src/request_files/tutorial001.py!}

⚙️ UploadFile ✔️ 📚 📈 🤭 bytes:

• 👆 🚫 ✔️ ⚙️ File() 🔢 💲 🔢.
• ⚫️ ⚙️ "🧵" 📁:
  • 📁 🏪 💾 🆙 🔆 📐 📉, & ⏮️ 🚶‍♀️ 👉 📉 ⚫️ 🔜 🏪 💾.
• 👉 ⛓ 👈 ⚫️ 🔜 👷 👍 ⭕ 📁 💖 🖼, 📹, ⭕ 💱, ♒️. 🍵 😩 🌐 💾.
• 👆 💪 🤚 🗃 ⚪️➡️ 📂 📁.
• ⚫️ ✔️ 📁-💖 async 🔢.
• ⚫️ 🎦 ☑ 🐍 SpooledTemporaryFile 🎚 👈 👆 💪 🚶‍♀️ 🔗 🎏 🗃 👈 ⌛ 📁-💖 🎚.

UploadFile

UploadFile ✔️ 📄 🔢:

• filename: str ⏮️ ⏮️ 📁 📛 👈 📂 (✅ myimage.jpg).
• content_type: str ⏮️ 🎚 🆎 (📁 🆎 / 📻 🆎) (✅ image/jpeg).
• file: SpooledTemporaryFile ( 📁-💖 🎚). 👉 ☑ 🐍 📁 👈 👆 💪 🚶‍♀️ 🔗 🎏 🔢 ⚖️ 🗃 👈 ⌛ "📁-💖" 🎚.

UploadFile ✔️ 📄 async 👩‍🔬. 👫 🌐 🤙 🔗 📁 👩‍🔬 🔘 (⚙️ 🔗 SpooledTemporaryFile).

• write(data): ✍ data (str ⚖️ bytes) 📁.
• read(size): ✍ size (int) 🔢/🦹 📁.
• seek(offset): 🚶 🔢 🧘 offset (int) 📁.
  • 🤶 Ⓜ., await myfile.seek(0) 🔜 🚶 ▶️ 📁.
  • 👉 ✴️ ⚠ 🚥 👆 🏃 await myfile.read() 🕐 & ⤴️ 💪 ✍ 🎚 🔄.
• close(): 🔐 📁.

🌐 👫 👩‍🔬 async 👩‍🔬, 👆 💪 "⌛" 👫.

🖼, 🔘 async ➡ 🛠️ 🔢 👆 💪 🤚 🎚 ⏮️:

contents = await myfile.read()

🚥 👆 🔘 😐 def ➡ 🛠️ 🔢, 👆 💪 🔐 UploadFile.file 🔗, 🖼:

contents = myfile.file.read()

!!! note "async 📡 ℹ" 🕐❔ 👆 ⚙️ async 👩‍🔬, FastAPI 🏃 📁 👩‍🔬 🧵 & ⌛ 👫.

!!! note "💃 📡 ℹ" FastAPI'Ⓜ UploadFile 😖 🔗 ⚪️➡️ 💃'Ⓜ UploadFile, ✋️ 🚮 💪 🍕 ⚒ ⚫️ 🔗 ⏮️ Pydantic & 🎏 🍕 FastAPI.

⚫️❔ "📨 💽"

🌌 🕸 📨 (<form></form>) 📨 💽 💽 🛎 ⚙️ "🎁" 🔢 👈 📊, ⚫️ 🎏 ⚪️➡️ 🎻.

FastAPI 🔜 ⚒ 💭 ✍ 👈 📊 ⚪️➡️ ▶️️ 🥉 ↩️ 🎻.

!!! note "📡 ℹ" 📊 ⚪️➡️ 📨 🛎 🗜 ⚙️ "📻 🆎" application/x-www-form-urlencoded 🕐❔ ⚫️ 🚫 🔌 📁.

✋️ 🕐❔ 📨 🔌 📁, ⚫️ 🗜 `multipart/form-data`. 🚥 👆 ⚙️ `File`, **FastAPI** 🔜 💭 ⚫️ ✔️ 🤚 📁 ⚪️➡️ ☑ 🍕 💪.

🚥 👆 💚 ✍ 🌖 🔃 👉 🔢 &amp; 📨 🏑, 👳 <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST" class="external-link" target="_blank"><abbr title="Mozilla Developer Network">🏇</abbr> 🕸 🩺 <code>POST</code></a>.

!!! warning 👆 💪 📣 💗 File & Form 🔢 ➡ 🛠️, ✋️ 👆 💪 🚫 📣 Body 🏑 👈 👆 ⌛ 📨 🎻, 📨 🔜 ✔️ 💪 🗜 ⚙️ multipart/form-data ↩️ application/json.

👉 🚫 🚫 **FastAPI**, ⚫️ 🍕 🇺🇸🔍 🛠️.

📦 📁 📂

👆 💪 ⚒ 📁 📦 ⚙️ 🐩 🆎 ✍ & ⚒ 🔢 💲 None:

=== "🐍 3️⃣.6️⃣ & 🔛"

```Python hl_lines="9  17"
{!> ../../../docs_src/request_files/tutorial001_02.py!}
```

=== "🐍 3️⃣.1️⃣0️⃣ & 🔛"

```Python hl_lines="7  14"
{!> ../../../docs_src/request_files/tutorial001_02_py310.py!}
```

UploadFile ⏮️ 🌖 🗃

👆 💪 ⚙️ File() ⏮️ UploadFile, 🖼, ⚒ 🌖 🗃:

{!../../../docs_src/request_files/tutorial001_03.py!}

💗 📁 📂

⚫️ 💪 📂 📚 📁 🎏 🕰.

👫 🔜 👨‍💼 🎏 "📨 🏑" 📨 ⚙️ "📨 💽".

⚙️ 👈, 📣 📇 bytes ⚖️ UploadFile:

=== "🐍 3️⃣.6️⃣ & 🔛"

```Python hl_lines="10  15"
{!> ../../../docs_src/request_files/tutorial002.py!}
```

=== "🐍 3️⃣.9️⃣ & 🔛"

```Python hl_lines="8  13"
{!> ../../../docs_src/request_files/tutorial002_py39.py!}
```

👆 🔜 📨, 📣, list bytes ⚖️ UploadFileⓂ.

!!! note "📡 ℹ" 👆 💪 ⚙️ from starlette.responses import HTMLResponse.

**FastAPI** 🚚 🎏 `starlette.responses` `fastapi.responses` 🏪 👆, 👩‍💻. ✋️ 🌅 💪 📨 👟 🔗 ⚪️➡️ 💃.

💗 📁 📂 ⏮️ 🌖 🗃

& 🎏 🌌 ⏭, 👆 💪 ⚙️ File() ⚒ 🌖 🔢, UploadFile:

=== "🐍 3️⃣.6️⃣ & 🔛"

```Python hl_lines="18"
{!> ../../../docs_src/request_files/tutorial003.py!}
```

=== "🐍 3️⃣.9️⃣ & 🔛"

```Python hl_lines="16"
{!> ../../../docs_src/request_files/tutorial003_py39.py!}
```

🌃

⚙️ File, bytes, & UploadFile 📣 📁 📂 📨, 📨 📨 💽.