Flask Session API
Session se utiliza para guardar datos entre diferentes solicitudes del mismo usuario. Flask usa por defecto cookies firmadas; los datos se almacenan en el cliente pero no pueden ser manipulados.
Mediantefrom flask import sessionimportar, y usarlo como un diccionario.
objeto proxy de session
sessionEs un proxy que apunta a la instancia SessionMixin de la solicitud actual. Solo está disponible en el contexto de la solicitud.
| Atributos/Métodos | Descripción |
|---|---|
| session[key] = value | Establece un valor de session |
| session.get(key, default) | Obtiene de forma segura un valor de session; si la clave no existe, devuelve default |
| session.pop(key, default) | Elimina y devuelve el valor de la clave especificada |
| session.clear() | Vacía todos los datos de session |
| "key" in session | Comprueba si la clave existe |
| session.permanent | Cuando se establece en True, la Session se mantiene después de cerrar el navegador (usa PERMANENT_SESSION_LIFETIME) |
| session.modified | Al modificar valores mutables en session (como append en listas), debe establecerse manualmente en True |
| session.accessed | Es True cuando se accede a session; Flask añade automáticamente la cabecera Vary: Cookie |
| session.new | Indica si session es de nueva creación (algunas implementaciones no admiten una determinación precisa) |
Al modificar objetos mutables anidados en session (como listas, diccionarios), Flask no puede detectar automáticamente el cambio.
Debe establecerse manualmentesession.modified = True; de lo contrario, los cambios no se guardarán en la Cookie.
Elementos de configuración
| Clave de configuración | Valor predeterminado | Descripción |
|---|---|---|
| SECRET_KEY | None | Clave para firmar Session; debe configurarse para poder usar Session |
| SESSION_COOKIE_NAME | "session" | Nombre de la Cookie de Session |
| SESSION_COOKIE_DOMAIN | None | Atributo Domain de la Cookie |
| SESSION_COOKIE_PATH | None | Atributo Path de la Cookie |
| SESSION_COOKIE_HTTPONLY | True | Prohíbe el acceso de JavaScript a la Cookie de Session |
| SESSION_COOKIE_SECURE | False | Cuando es True, la Cookie solo se envía mediante HTTPS |
| SESSION_COOKIE_SAMESITE | None | "Strict", "Lax" o None |
| PERMANENT_SESSION_LIFETIME | timedelta(days=31) | Período de validez de la Session permanente |
| SESSION_REFRESH_EACH_REQUEST | True | Actualizar la validez de la Cookie de Session en cada solicitud |
Ejemplo de código
Ejemplo
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'Logged in as {session["username"]}'
return 'You are not logged in'
@app.route("/login", methods=["GET", "POST"])
def login():
if request.method == "POST":
session["username"] = request.form["username"]
# Configurar session permanente (se mantiene 31 días después de cerrar el navegador)
session.permanent = True
return redirect(url_for("index"))
return '<form method="post"><input name="username"></form>'
@app.route("/appends")
def append_to_list():
# Nota: modificar listas anidadas requiere marcar manualmente modified
if "items" not in session:
session["items"] = []
session["items"].append("new_item")
session.modified = True # ¡Debe marcarse manualmente!
return f'Items: {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'Logged in as {session["username"]}'
return 'You are not logged in'
@app.route("/login", methods=["GET", "POST"])
def login():
if request.method == "POST":
session["username"] = request.form["username"]
# Configurar session permanente (se mantiene 31 días después de cerrar el navegador)
session.permanent = True
return redirect(url_for("index"))
return '<form method="post"><input name="username"></form>'
@app.route("/appends")
def append_to_list():
# Nota: modificar listas anidadas requiere marcar manualmente modified
if "items" not in session:
session["items"] = []
session["items"].append("new_item")
session.modified = True # ¡Debe marcarse manualmente!
return f'Items: {session["items"]}'
@app.route("/logout")
def logout():
session.clear()
return redirect(url_for("index"))