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"))
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"))