Berkas Statis¶
Anda dapat menyajikan berkas statis secara otomatis dari sebuah direktori menggunakan StaticFiles
.
Penggunaan StaticFiles
¶
- Mengimpor
StaticFiles
. - "Mount" representatif
StaticFiles()
di jalur spesifik.
from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles
app = FastAPI()
app.mount("/static", StaticFiles(directory="static"), name="static")
Detail Teknis
Anda dapat pula menggunakan from starlette.staticfiles import StaticFiles
.
FastAPI menyediakan starlette.staticfiles
sama seperti fastapi.staticfiles
sebagai kemudahan pada Anda, yaitu para pengembang. Tetapi ini asli berasal langsung dari Starlette.
Apa itu "Mounting"¶
"Mounting" dimaksud menambah aplikasi "independen" secara lengkap di jalur spesifik, kemudian menangani seluruh sub-jalur.
Hal ini berbeda dari menggunakan APIRouter
karena aplikasi yang dimount benar-benar independen. OpenAPI dan dokumentasi dari aplikasi utama Anda tak akan menyertakan apa pun dari aplikasi yang dimount, dst.
Anda dapat mempelajari mengenai ini dalam Panduan Pengguna Lanjutan.
Detail¶
Terhadap "/static"
pertama mengacu pada sub-jalur yang akan menjadi tempat "sub-aplikasi" ini akan "dimount". Maka, jalur apa pun yang dimulai dengan "/static"
akan ditangani oleh sub-jalur tersebut.
Terhadap directory="static"
mengacu pada nama direktori yang berisi berkas statis Anda.
Terhadap name="static"
ialah nama yang dapat digunakan secara internal oleh FastAPI.
Seluruh parameter ini dapat berbeda dari sekadar "static
", sesuaikan parameter dengan keperluan dan detail spesifik akan aplikasi Anda.
Info lanjutan¶
Sebagai detail dan opsi tambahan lihat dokumentasi Starlette perihal Berkas Statis.