您好,欢迎访问一九零五行业门户网

php实例之Laravel认证原理以及完全自定义认证详解

最近在学习laravel框架,所以下面这篇文章主要给大家介绍了关于laravel认证原理以及完全自定义认证的相关资料,文中通过示例代码介绍的非常详细,需要的朋友可以参考借鉴,下面随着小编来一起学习学习吧
前言
laravel 默认的 auth 功能已经是很全面了,但是我们也经常会碰到一些需要自定义的一些情况,比如验证的字段和默认的不匹配,比如需要能够同时满足 user name 和 email 认证等等。如何创建一个完全自定义的认证呢?相比一个教程,我更倾向于介绍一下工作原理,这样在自己修改或自定义的过程中更得心应手。
authenticatable 接口
illuminate\contracts\auth\authenticatable
authenticatable 定义了一个可以被用来认证的模型或类需要实现的接口,也就是说,如果需要用一个自定义的类来做认证,需要实现这个接口定义的方法。
// 获取唯一标识的,可以用来认证的字段名,比如 id,uuidpublic function getauthidentifiername();// 获取该标示符对应的值public function getauthidentifier();// 获取认证的密码public function getauthpassword();// 获取remember tokenpublic function getremembertoken();// 设置 remember tokenpublic function setremembertoken($value);// 获取 remember token 对应的字段名,比如默认的 'remember_token'public function getremembertokenname();
比如你的认证模型需要用 'token' 而不是 'password' 来作为密码验证,这个时候就可以修改 getauthpassword() 方法的返回值为 'token';
authenticatable trait
illuminate\auth\authenticatable
laravel 中定义的 authenticatable trait,也是 laravel auth 默认的 user 模型使用的 trait,这个 trait 定义了 user 模型默认认证标示符为 'id',密码字段为 'password',remember token 对应的字段为 remember_token 等等。
通过重写 user 模型的这些方法可以修改一些设置。
guard 接口
illuminate\contracts\auth\guard
guard 接口定义了某个实现了 authenticatable (可认证的) 模型或类的认证方法以及一些常用的接口。
// 判断当前用户是否登录public function check();// 判断当前用户是否是游客(未登录)public function guest();// 获取当前认证的用户public function user();// 获取当前认证用户的 id,严格来说不一定是 id,应该是上个模型中定义的唯一的字段名public function id();// 根据提供的消息认证用户public function validate(array $credentials = []);// 设置当前用户public function setuser(authenticatable $user);
statefulguard 接口
illuminate\contracts\auth\statefulguard
statefulguard 接口继承自 guard 接口,除了 guard 里面定义的一些基本接口外,还增加了更进一步、有状态的 guard.
新添加的接口有这些:
// 尝试根据提供的凭证验证用户是否合法public function attempt(array $credentials = [], $remember = false);// 一次性登录,不记录session or cookiepublic function once(array $credentials = []);// 登录用户,通常在验证成功后记录 session 和 cookie public function login(authenticatable $user, $remember = false);// 使用用户 id 登录public function loginusingid($id, $remember = false);// 使用用户 id 登录,但是不记录 session 和 cookiepublic function onceusingid($id);// 通过 cookie 中的 remember token 自动登录public function viaremember();// 登出public function logout();
laravel 中默认提供了 3 中 guard:requestguard,tokenguard,sessionguard.
requestguard
illuminate\auth\requestguard
requestguard 是一个非常简单的 guard. requestguard 是通过传入一个闭包来认证的。可以通过调用 auth::viarequest 添加一个自定义的 requestguard.
sessionguard
illuminate\auth\sessionguard
sessionguard 是 laravel web 认证默认的 guard.
tokenguard
illuminate\auth\tokenguard
tokenguard 适用于无状态 api 认证,通过 token 认证.
userprovider 接口
illuminate\contracts\auth\userprovider
userprovider 接口定义了获取认证模型的方法,比如根据 id 获取模型,根据 email 获取模型等等.
// 通过唯一标示符获取认证模型public function retrievebyid($identifier);// 通过唯一标示符和 remember token 获取模型public function retrievebytoken($identifier, $token);// 通过给定的认证模型更新 remember tokenpublic function updateremembertoken(authenticatable $user, $token);// 通过给定的凭证获取用户,比如 email 或用户名等等public function retrievebycredentials(array $credentials);// 认证给定的用户和给定的凭证是否符合public function validatecredentials(authenticatable $user, array $credentials);
laravel 中默认有两个 user provider: databaseuserprovider & eloquentuserprovider.
databaseuserprovider
illuminate\auth\databaseuserprovider
直接通过数据库表来获取认证模型.
eloquentuserprovider
illuminate\auth\eloquentuserprovider
通过 eloquent 模型来获取认证模型
authmanager
illuminate\auth\authmanager
guard 用来认证一个用户是否认证成功, userprovider 用来提供认证模型的来源,而根据项目的 config 管理 guard 以及自定义 guard 等等功能,则是通过 authmanager 来实现。
authmanager 应该是有点像策略模式里面的 context 类以及工厂方法里面的工厂,一方面管理 guard,另外一方面通过 __call 魔术方法调用具体的策略(guard)方法。
auth facade 对应的实现类就是 authmanager,authmanager 在容器中注册为单例,用来管理所有的 guard、user provider 以及 guard 的代理工作。
自定义认证
根据上面的知识,可以知道要自定义一个认证很简单。
创建认证模型
创建一个自定义的认证模型,实现 authenticatable 接口;
创建自定义的 userprovider
创建一个自定义的 userprovider,实现 userprovider 接口,可以返回上面自定义的认证模型;
创建自定义的 guard
创建一个自定义的 guard,实现 guard或statefulguard 接口
添加 guard creator 和 user provider creator 到 authmanager 中
在 appserviceprovider 的 boot 方法添加如下代码:
auth::extend('myguard', function(){ ... return new myguard(); //返回自定义 guard 实例 ...});auth::provider('myuserprovider', function(){ return new myuserprovider(); // 返回自定义的 user provider});
在 config\auth.php的 guards 数组中添加自定义 guard,一个自定义 guard 包括两部分: driver 和 provider.
'oustn' => [ 'driver' => 'myguard', 'provider' => 'myusers',],
在 config\auth.php的 providers 数组中添加自定义 user provider.
'myusers' => [ 'driver' => 'myuserprovider' // 里面具体的字段可以根据你创建 user provider 需要的信息自由添加,可以通过 auth::createuserprovider('myuserprovider') 创建],
设置 config\auth.php 的 defaults.guard 为 oustn.
以上就是php实例之laravel认证原理以及完全自定义认证详解的详细内容。
其它类似信息

推荐信息