Ana içeriğe geç

Statik Dosyalar

StaticFiles'ı kullanarak statik dosyaları bir yol altında sunabilirsiniz.

StaticFiles Kullanımı

  • StaticFiles sınıfını projenize dahil edin.
  • Bir StaticFiles() örneğini belirli bir yola bağlayın.
from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles

app = FastAPI()

app.mount("/static", StaticFiles(directory="static"), name="static")

Teknik Detaylar

Projenize dahil etmek için from starlette.staticfiles import StaticFiles kullanabilirsiniz.

FastAPI, geliştiricilere kolaylık sağlamak amacıyla starlette.staticfilesfastapi.staticfiles olarak sağlar. Ancak StaticFiles sınıfı aslında doğrudan Starlette'den gelir.

Bağlama (Mounting) Nedir?

"Bağlamak", belirli bir yola tamamen "bağımsız" bir uygulama eklemek anlamına gelir ve ardından tüm alt yollara gelen istekler bu uygulama tarafından işlenir.

Bu, bir APIRouter kullanmaktan farklıdır çünkü bağlanmış bir uygulama tamamen bağımsızdır. Ana uygulamanızın OpenAPI ve dokümanlar, bağlanmış uygulamadan hiçbir şey içermez, vb.

Advanced User Guide bölümünde daha fazla bilgi edinebilirsiniz.

Detaylar

"/static" ifadesi, bu "alt uygulamanın" "bağlanacağı" alt yolu belirtir. Bu nedenle, "/static" ile başlayan her yol, bu uygulama tarafından işlenir.

directory="static" ifadesi, statik dosyalarınızı içeren dizinin adını belirtir.

name="static" ifadesi, alt uygulamanın FastAPI tarafından kullanılacak ismini belirtir.

Bu parametrelerin hepsi "static"den farklı olabilir, bunları kendi uygulamanızın ihtiyaçlarına göre belirleyebilirsiniz.

Daha Fazla Bilgi

Daha fazla detay ve seçenek için Starlette'in Statik Dosyalar hakkındaki dokümantasyonunu incelleyin.