Flask-Session-API

Session wird verwendet, um Daten zwischen verschiedenen Anfragen desselben Benutzers zu speichern. Flask implementiert dies standardmäßig mit signierten Cookies; die Daten werden auf dem Client gespeichert, können aber nicht manipuliert werden.

Durchfrom flask import sessionimportieren und wie ein Dictionary verwenden.


session-Proxy-Objekt

sessionEs ist ein Proxy, der auf die SessionMixin-Instanz der aktuellen Anfrage verweist. Es ist nur im Request-Kontext verfügbar.

Attribute/Methoden Beschreibung
session[key] = value session-Wert setzen
session.get(key, default) Sicher einen session-Wert abrufen, wobei default zurückgegeben wird, wenn der Schlüssel nicht existiert.
session.pop(key, default) Den Wert für den angegebenen Schlüssel entfernen und zurückgeben.
session.clear() Alle Sitzungsdaten löschen.
"key" in session Prüfen, ob der Schlüssel existiert
session.permanent Wenn auf True gesetzt, bleibt die Sitzung nach dem Schließen des Browsers erhalten (verwendet PERMANENT_SESSION_LIFETIME)
session.modified Wenn veränderliche Werte in der Sitzung geändert werden (wie beim Anhängen an eine Liste), müssen Sie es manuell auf True setzen.
session.accessed Wenn True, fügt Flask automatisch den Header Vary: Cookie hinzu, wenn auf die Sitzung zugegriffen wird
session.new Ob die Sitzung neu erstellt wurde (manche Implementierungen unterstützen keine genaue Erkennung).

Wenn verschachtelte veränderbare Objekte in der Session geändert werden (wie Listen, Dictionaries), kann Flask die Änderung nicht automatisch erkennen.

Muss manuell festgelegt werdensession.modified = TrueAndernfalls wird die Änderung nicht im Cookie gespeichert.


Konfigurationselement

Konfigurationsschlüssel Standardwert Beschreibung
SECRET_KEY Keine Der geheime Schlüssel zum Signieren der Session; er muss festgelegt werden, um die Session zu verwenden.
SESSION_COOKIE_NAME "session" Session-Cookie-Name
SESSION_COOKIE_DOMAIN Keine Domain-Attribut des Cookies
SESSION_COOKIE_PATH Keine Path-Attribut des Cookies
SESSION_COOKIE_HTTPONLY True Verhindern, dass JavaScript auf das Session-Cookie zugreift
SESSION_COOKIE_SECURE False Wenn True, werden Cookies nur über HTTPS gesendet
SESSION_COOKIE_SAMESITE Keine "Strict", "Lax", oder None
PERMANENT_SESSION_LIFETIME timedelta(days=31) Die Gültigkeitsdauer einer permanenten Session.
SESSION_REFRESH_EACH_REQUEST True Erneuert die Gültigkeitsdauer des Session-Cookies bei jeder Anfrage.

Codebeispiele

Beispiel

from flask import Flask, session, redirect, url_for

app = Flask(__name__)
app.secret_key = "your-secret-key"

@app.route("/")
def index():
    if "username" in session:
        return f'Angemeldet als {session["username"]}'
    return 'Sie sind nicht angemeldet'

@app.route("/login", methods=["GET", "POST"])
def login():
    if request.method == "POST":
        session["username"] = request.form["username"]
        # Permanente Session setzen (bleibt 31 Tage nach dem Schließen des Browsers erhalten)
        session.permanent = True
        return redirect(url_for("index"))
    return '<form method="post"><input name="username"></form>'

@app.route("/appends")
def append_to_list():
    # Hinweis: Beim Ändern verschachtelter Listen muss modified manuell markiert werden
    if "items" not in session:
        session["items"] = []
    session["items"].append("new_item")
    session.modified = True  # Muss manuell markiert werden!
    return f'Elemente: {session["items"]}'

@app.route("/logout")
def logout():
    session.clear()
    return redirect(url_for("index"))
Weitere Erweiterungen