auth 高可扩展的认证插件

v2.0.0 版本
2022-09-18 版本更新时间
121 安装
5 star

为了后期更好的维护,最新 2.0 版本已修改包名,请注意切换

webman-tech/auth

Auth plugin for webman

简介

提供高可扩展的认证授权插件,包含以下功能:

  • [x] 多用户认证: AuthManager 管理多 guard 实例
  • [x] 多认证方式
    • [x] SessionMethod: session 认证
    • [x] RequestMethod: 请求参数认证,token 放在 query 或 post 中
    • [x] HttpHeaderMethod: 请求 Header 认证,token 放在 header 中
    • [x] HttpAuthorizationMethod: 请求 Header 中的 Authorization 认证
    • [x] HttpBasicMethod: 请求 Basic 认证
    • [x] HttpBearerMethod: 请求 Bearer 认证
    • [x] TinywanJwtMethod: 使用 tinywan/jwt 进行 jwt 认证
    • [x] CompositeMethod: 组合以上多种认证方式
  • [x] 多认证失败处理器
    • [x] RedirectHandler: 重定向处理器
    • [x] ResponseHandler: 响应 401 http status
    • [x] ThrowExceptionHandler: 抛出 UnauthorizedException 异常

安装

composer require webman-tech/auth

配置

详见: auth.php

使用

认证授权方法

use WebmanTech\Auth\Auth;

$guard = Auth::guard(); // 获取默认的 guard
$guard = Auth::guard('admin'); // 获取指定名称的 guard

$guard->login($user); // 用户登录
$guard->logout(); // 用户退出登录
$guard->getId(); // 获取当前登录用户的 id
$guard->getUser(); // 获取当前登录用户的实例
$guard->isGuest(); // 判断当前用户是否为游客

其他方法详见: GuardInterface

中间件

  • 全局切换 Guard: WebmanTech\Auth\Middleware\SetAuthGuard
  • 认证授权: WebmanTech\Auth\Middleware\Authentication

扩展

支持扩展以下接口:

例子

多种用户体系(前端用户api接口,后端用户session)

详见 examples/multi-user