2.8 KiB
Статичні файли
Ви можете автоматично надавати статичні файли з каталогу, використовуючи StaticFiles.
Використання StaticFiles
- Імпортуйте
StaticFiles. - «Під'єднати» екземпляр
StaticFiles()з вказанням необхідного шляху.
{* ../../docs_src/static_files/tutorial001_py39.py hl[2,6] *}
/// note | Технічні деталі
Ви також можете використовувати from starlette.staticfiles import StaticFiles.
FastAPI надає той самий starlette.staticfiles, що й fastapi.staticfiles для зручності розробників. Але фактично він безпосередньо походить із Starlette.
///
Що таке «Під'єднання»
«Під'єднання» означає додавання повноцінного «незалежного» застосунку за певним шляхом, який потім обробляє всі під шляхи.
Це відрізняється від використання APIRouter, оскільки під'єднаний застосунок є повністю незалежним. OpenAPI та документація вашого основного застосунку не будуть знати нічого про ваш під'єднаний застосунок тощо.
Ви можете дізнатися більше про це в Посібнику для просунутих користувачів{.internal-link target=_blank}.
Деталі
Перше "/static" вказує на під шлях, за яким буде «під'єднано» цей новий «підзастосунок». Тому будь-який шлях, який починається з "/static", буде оброблятися ним.
directory="static" визначає назву каталогу, що містить ваші статичні файли.
name="static" це ім'я, яке можна використовувати всередині FastAPI.
Усі ці параметри можуть бути іншими за "static", налаштуйте їх відповідно до потреб і особливостей вашого застосунку.
Додаткова інформація
Детальніше про налаштування та можливості можна дізнатися в документації Starlette про статичні файли.