Flask-Login 核心用法与信号机制详解

安装与初始化

首先，需要通过 pip 安装 Flask-Login 插件：

pip install flask-login

在 Flask 应用中，需实例化 LoginManager 并将其绑定到应用对象，以启用登录管理功能：

import flask import Flask
from flask_login import LoginManager
app = Flask(__name__)
login_manager = LoginManager()
login_manager.init_app(app)

用户模型定义

Flask-Login 提供了 UserMixin 类，该类包含了 is_authenticated、is_active、is_anonymous 属性以及 get_id() 方法。开发者可让自定义用户模型继承 UserMixin，从而自动获得这些必要的状态属性：

from flask_login import UserMixin,login_user
from sqlalchemy import create_engine,Column,String,Integer
from sqlalchemy.ext.declaractive import declaractive_base
engine = create_engine("mysql+pymysql://root:123456@localhost/pythondb?charset=utf8")
Base = declaractive_base()
class User(Base,UserMixin):
  __tablename__ = "user"
  id = Column(Integer,primary_key=True)
  name = Column(String(16))
  password = Column(String(16))
  def login(self):
    login_user(self)

在 User 模型中，通过调用 login_user(self) 方法可触发登录流程。该方法会向 Flask 发送 user_logged_in 信号，通知系统用户已成功登录。

信号监听与自定义操作

Flask-Login 提供了 6 种信号，其中 user_logged_in 信号可用于记录登录次数或登录 IP 等自定义操作。开发者可通过 connect_via 装饰器监听该信号：

from flask_login import user_logged_in
@user_logged_in.connect_via(app)
def _logged_in(sender,user,**extra):
  ...

在回调函数中，可以执行如增加登录计数、记录登录 IP 等业务逻辑。

用户加载回调

为了维持用户登录状态，必须定义 user_loader 回调函数。该函数接收用户 ID 作为参数，并返回对应的 User 对象：

# login_manager为上面初始化的login_manager
@login_manager.user_loader
def user_loader(id):
  return session.query(User).filter_by(id=id).first()

此回调决定了当前会话中 user 对象的登录状态，确保 Flask 能正确识别已认证用户。

路由保护

对于需要登录才能访问的路由，可使用 login_required 装饰器进行保护：

from flask_login import login_required
@app.route("/user_info")
@login_required
def user_info():
  ...

未登录用户访问受保护路由时，Flask-Login 会自动将其重定向到登录页面或返回 401 错误，具体行为取决于 LoginManager 的配置。

总结

通过继承 UserMixin、配置 user_loader 以及利用信号机制，Flask-Login 为 Flask 应用提供了完整且灵活的用户认证解决方案。开发者可根据实际需求扩展信号监听逻辑，实现更精细的登录行为管理。

以上就是 Flask-Login 核心用法与信号机制详解的详细内容，更多关于 Flask-Login、Flask 用户认证的资料请关注本站其它相关文章！