Statische Dateien¶
🌐 Übersetzung durch KI und Menschen
Diese Übersetzung wurde von KI erstellt, angeleitet von Menschen. 🤝
Sie könnte Fehler enthalten, etwa Missverständnisse des ursprünglichen Sinns oder unnatürliche Formulierungen, usw. 🤖
Sie können diese Übersetzung verbessern, indem Sie uns helfen, die KI-LLM besser anzuleiten.
Mit StaticFiles können Sie statische Dateien aus einem Verzeichnis automatisch bereitstellen.
Tipp
Wenn Sie ein Frontend hosten müssen, verwenden Sie stattdessen app.frontend(); lesen Sie mehr dazu unter Frontend.
app.frontend() verwendet darunter StaticFiles, mit mehreren zusätzlichen Vorteilen für Frontends, wie der Handhabung von clientseitigem Routing.
StaticFiles verwenden¶
- Importieren Sie
StaticFiles. - „Mounten" Sie eine
StaticFiles()-Instanz in einem bestimmten Pfad.
fromfastapiimport FastAPI
fromfastapi.staticfilesimport StaticFiles
app = FastAPI()
app.mount("/static", StaticFiles(directory="static"), name="static")
Technische Details
Sie könnten auch from starlette.staticfiles import StaticFiles verwenden.
FastAPI stellt dasselbe starlette.staticfiles auch via fastapi.staticfiles bereit, als Annehmlichkeit für Sie, den Entwickler. Es kommt aber tatsächlich direkt von Starlette.
Was ist „Mounten"¶
„Mounten" bedeutet das Hinzufügen einer vollständigen „unabhängigen" Anwendung an einem bestimmten Pfad, die sich dann um die Handhabung aller Unterpfade kümmert.
Dies unterscheidet sich von der Verwendung eines APIRouter, da eine gemountete Anwendung völlig unabhängig ist. Die OpenAPI und Dokumentation Ihrer Hauptanwendung enthalten nichts von der gemounteten Anwendung, usw.
Weitere Informationen hierzu finden Sie im Handbuch für fortgeschrittene Benutzer.
Einzelheiten¶
Das erste "/static" bezieht sich auf den Unterpfad, auf dem diese „Unteranwendung" „gemountet" wird. Daher wird jeder Pfad, der mit "/static" beginnt, von ihr verarbeitet.
Das directory="static" bezieht sich auf den Namen des Verzeichnisses, das Ihre statischen Dateien enthält.
Das name="static" gibt dieser Unteranwendung einen Namen, der intern von FastAPI verwendet werden kann.
Alle diese Parameter können anders als „static" lauten, passen Sie sie an die Bedürfnisse und spezifischen Details Ihrer eigenen Anwendung an.
Weitere Informationen¶
Weitere Details und Optionen finden Sie in Starlettes Dokumentation zu statischen Dateien.