auth 高可扩展的认证插件
v2.0.1
版本
2023-05-24
版本更新时间
4493
安装
12
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
扩展
支持扩展以下接口:
- 认证方式接口:
AuthenticationMethodInterface
- 认证失败处理方式接口:
AuthenticationFailureHandlerInterface
- Guard 接口:
GuardInterface
例子
多种用户体系(前端用户api接口,后端用户session)