Статичні файли¶
🌐 Переклад ШІ та людьми
Цей переклад виконано ШІ під керівництвом людей. 🤝
Можливі помилки через неправильне розуміння початкового змісту або неприродні формулювання тощо. 🤖
Ви можете покращити цей переклад, допомігши нам краще спрямовувати AI LLM.
Ви можете автоматично надавати статичні файли з каталогу, використовуючи StaticFiles.
Порада
Якщо вам потрібно розмістити фронтенд, натомість використовуйте app.frontend(), прочитайте про це у Frontend.
app.frontend() використовує StaticFiles всередині, з кількома додатковими перевагами для фронтендів, як-от обробка клієнтської маршрутизації.
Використання StaticFiles¶
- Імпортуйте
StaticFiles. - «Змонтуйте» екземпляр
StaticFiles()у певному шляху.
from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles
app = FastAPI()
app.mount("/static", StaticFiles(directory="static"), name="static")
Технічні деталі
Ви також можете використовувати from starlette.staticfiles import StaticFiles.
FastAPI надає той самий starlette.staticfiles, що й fastapi.staticfiles для зручності розробників. Але фактично він безпосередньо походить із Starlette.
Що таке «Монтування»¶
«Монтування» означає додавання повноцінного «незалежного» застосунку за певним шляхом, який потім відповідає за обробку всіх підшляхів.
Це відрізняється від використання APIRouter, оскільки змонтований застосунок є повністю незалежним. OpenAPI та документація вашого основного застосунку не включатимуть нічого зі змонтованого застосунку тощо.
Ви можете дізнатися більше про це в Просунутому посібнику користувача.
Деталі¶
Перше "/static" стосується підшляху, на якому буде «змонтовано» цей «підзастосунок». Тому будь-який шлях, який починається з "/static", буде оброблятися ним.
directory="static" визначає назву каталогу, що містить ваші статичні файли.
name="static" надає йому ім'я, яке можна використовувати всередині FastAPI.
Усі ці параметри можуть бути іншими за "static", налаштуйте їх відповідно до потреб і особливостей вашого застосунку.
Додаткова інформація¶
Для отримання додаткової інформації та параметрів перевірте документацію Starlette про Static Files.