Statische Dateien¶
Mit StaticFiles können Sie statische Dateien aus einem Verzeichnis automatisch bereitstellen.
StaticFiles verwenden¶
- Importieren Sie
StaticFiles. - „Mounten“ Sie eine
StaticFiles()-Instanz in einem bestimmten Pfad.
from fastapi import FastAPI
from fastapi.staticfiles import 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 der Dokumentation von Starlette zu statischen Dateien.