Laravel 学习之 Auth 模块详解

w8484855@qq.com

本文和大家分享的主要是Laravel 中 Auth 模块相关内容，一起来看看吧，希望对大家学习Laravel有所帮助。
　　注：本文是基于 Laravel 5.4 版本的本地化模块代码进行分析书写；
　　模块组成
　　Auth 模块从功能上分为用户认证和权限管理两个部分；从文件组成上， Illuminate\Auth\Passwords 目录下是密码重置或忘记密码处理的小模块， Illuminate\Auth 是负责用户认证和权限管理的模块， Illuminate\Foundation\Auth 提供了登录、修改密码、重置密码等一系统列具体逻辑实现；下图展示了 Auth 模块各个文件的关系，并进行简要说明；

用户认证
　　HTTP 本身是无状态，通常在系统交互的过程中，使用账号或者 Token 标识来确定认证用户；
　　配置文件解读
　　return [
　　'defaults' => [
　　'guard' => 'web',
　　...
　　],
　　'guards' => [
　　'web' => [
　　'driver' => 'session',
　　'provider' => 'users',
　　],
　　'api' => [
　　'driver' => 'token',
　　'provider' => 'users',
　　],
　　],
　　'providers' => [
　　'users' => [
　　'driver' => 'eloquent',
　　'model' => App\User::class,
　　],
　　],
　　],
　　];
　　从下往上，理解；
　　providers 是提供用户数据的接口，要标注驱动对象和目标对象；此处，键名 users 是一套 provider 的名字，采用 eloquent 驱动， modal 是 App\User::class ；
　　guards 部分针对认证管理部分进行配置；有两种认证方式，一种叫 web ，还有一种是 api ； web 认证是基于 Session 交互，根据 sessionId 获取用户 id ，在 users 这个 provider 查询出此用户； api 认证是基于 token 值交互，也采用 users 这个 provider ；
　　defaults 项显示默认使用 web 认证；
　　认证
　　1.Session 绑定认证信息：
　　// $credentials数组存放认证条件，比如邮箱或者用户名、密码
　　// $remember 表示是否要记住，生成 `remember_token`
　　public function attempt(array $credentials = [], $remember = false)
　　public function login(AuthenticatableContract $user, $remember = false)
　　public function loginUsingId($id, $remember = false)
　　HTTP 基本认证，认证信息放在请求头部；后面的请求访问通过 sessionId ；
　　public function basic($field = 'email', $extraConditions = [])
　　2.只在当前会话中认证， session 中不记录认证信息：
　　public function once(array $credentials = [])
　　public function onceUsingId($id)
　　public function onceBasic($field = 'email', $extraConditions = [])
　　认证过程中（包括注册、忘记密码），定义的事件有这些：

还有一些其他的认证方法：
　　Auth::check()Auth::user()Auth::logout()
　　密码处理
　　配置解读
　　return [
　　'defaults' => [
　　'passwords' => 'users',
　　...
　　],
　　'passwords' => [
　　'users' => [
　　'provider' => 'users',
　　'table' => 'password_resets',
　　'expire' => 60,
　　],
　　],
　　]
　　从下往上，看配置；
　　passwords 数组是重置密码的配置； users 是配置方案的别名，包含三个元素： provider（提供用户的方案，是上面 providers 数组）、 table （存放重置密码 token 的表）、 expire （ token 过期时间）
　　default 项会设置默认的 passwords 重置方案；
　　重置密码的调用与实现
　　先看看 Laravel 的重置密码功能是怎么实现的：
　　public function reset(array $credentials, Closure $callback) {
　　// 验证用户名、密码和 token 是否有效
　　$user = $this->validateReset($credentials);
　　if (! $user instanceof CanResetPasswordContract) {
　　return $user;
　　}
　　$password = $credentials['password'];
　　// 回调函数执行修改密码，及持久化存储
　　$callback($user, $password);
　　// 删除重置密码时持久化存储保存的 token
　　$this->tokens->delete($user);
　　return static::PASSWORD_RESET;
　　}
　　再看看 Foundation\Auth 模块封装的重置密码模块是怎么调用的：
　　// 暴露的重置密码 APIpublic function reset(Request $request)   {
　　// 验证请求参数 token、email、password、password_confirmation
　　$this->validate($request, $this->rules(), $this->validationErrorMessages());
　　// 调用重置密码的方法，第二个参数是回调，做一些持久化存储工作
　　$response = $this->broker()->reset(
　　$this->credentials($request), function ($user, $password) {
　　$this->resetPassword($user, $password);
　　}
　　);
　　// 封装 Response
　　return $response == Password::PASSWORD_RESET
　　? $this->sendResetResponse($response)
　　: $this->sendResetFailedResponse($request, $response);
　　}
　　// 获取重置密码时的请求参数protected function credentials(Request $request)  {
　　return $request->only(
　　'email', 'password', 'password_confirmation', 'token'
　　);
　　}
　　// 重置密码的真实性验证后，进行的持久化工作protected function resetPassword($user, $password) {
　　// 修改后的密码、重新生成 remember_token
　　$user->forceFill([
　　'password' => bcrypt($password),
　　'remember_token' => Str::random(60),
　　])->save();
　　// session 中的用户信息也进行重新赋值
　　$this->guard()->login($user);
　　}
　　“忘记密码 => 发邮件 => 重置密码” 的大体流程如下：
　　1.点击“忘记密码”，通过路由配置，跳到“忘记密码”页面，页面上有“要发送的邮箱”这个字段要填写；
　　2.验证“要发送的邮箱”是否是数据库中存在的，如果存在，即向该邮箱发送重置密码邮件；
　　3.重置密码邮件中有一个链接（点击后会携带 token 到修改密码页面），同时数据库会保存这个 token 的哈希加密后的值；
　　4.填写“邮箱”，“密码”，“确认密码”三个字段后，携带 token 访问重置密码 API ，首页判断邮箱、密码、确认密码这三个字段，然后验证 token 是否有效；如果是，则重置成功；
　　权限管理
　　权限管理是依靠内存空间维护的一个数组变量 abilities 来维护，结构如下：
　　$abilities = array(
　　'定义的动作名，比如以路由的 as 名(common.dashboard.list)' => function($user) {
　　// 方法的参数，第一位是 $user, 当前 user, 后面的参数可以自行决定
　　return true;  // 返回 true 意味有权限， false 意味没有权限
　　},
　　......
　　);
　　但只用 $abilities ，会使用定义的那部分代码集中在一起太烦索，所以有 policy 策略类的出现；
　　policy 策略类定义一组实体及实体权限类的对应关系，比如以文章举例：
　　有一个 Modal 实体类叫 Post ，可以为这个实体类定义一个 PostPolicy 权限类，在这个权限类定义一些动作为方法名；
　　class PostPolicy {
　　// update 权限，文章作者才可以修改
　　public function update(User $user, Post $post) {
　　return $user->id === $post->user_id;
　　}
　　}
　　然后在 ServiceProvider 中注册，这样系统就知道，如果你要检查的类是 Post 对象，加上你给的动作名，系统会找到 PostPolicy 类的对应方法；
　　protected $policies = [
　　Post::class => PostPolicy::class,
　　];
　　怎么调用呢？
　　对于定义在abilities数组的权限：
　　·当前用户是否具备 common.dashboard.list 权限： Gate::allows('common.dashboard.list')
　　·当前用户是否具备 common.dashboard.list 权限： ! Gate::denies('common.dashboard.list')
　　·当前用户是否具备 common.dashboard.list 权限： $request->user()->can('common.dashboard.list')
　　·当前用户是否具备 common.dashboard.list 权限： ! $request->user()->cannot('common.dashboard.list')
　　·指定用户是否具备 common.dashboard.list 权限： Gate::forUser($user)->allows('common.dashboard.list')
　　对于policy策略类调用的权限：
　　·当前用户是否可以修改文章（Gate 调用）： Gate::allows('update', $post)
　　·当前用户是否可以修改文章（user 调用）： $user->can('update', $post)
　　·当前用户是否可以修改文章（用帮助函数）： policy($post)->update($user, $post)
　　·当前用户是否可以修改文章（Controller 类方法中调用）： $this->authorize('update', $post);
　　·当前用户是否可以修改文章（Controller 类同名方法中调用）： $this->authorize($post);
　　·指定用户是否可以修改文章（Controller 类方法中调用）： $this->authorizeForUser($user, 'update', $post);
　　有用的技巧
　　获取当前系统注册的权限，包括两部分 abilities 和 policies 数组内容，代码如下：
　　$gate = app(\Illuminate\Contracts\Auth\Access\Gate::class);
　　$reflection_gate = new ReflectionClass($gate);
　　$policies = $reflection_gate->getProperty('policies');
　　$policies->setAccessible(true);// 获取当前注册的 policies 数组
　　dump($policies->getValue($gate));
　　$abilities = $reflection_gate->getProperty('abilities');
　　$abilities->setAccessible(true);// 获取当前注册的 abilities 数组
　　dump($abilities->getValue($gate));


来源：SegmentFault