认证与授权

Blink 提供了一套轻量级的认证授权框架，通过这套框架我们可以更加方便的在我们的应用中实现认证与授权的系列功能。

在 Blink 中，认证特性是由 auth 服务组件来完成的，我们可以通过 auth() 辅助函数来获取该服务的实例。为了让auth 服务知道如何查找一个 用户并验证其密码的正确性，我们首先需要定义一个 User Identity 类来告诉 auth 服务这些信息：

定义 User Identity

为了定义一个 User Identity 类，我们需要实现 blink\auth\Authenticatable 接口，下面的例子展示了如何利用静态用户数据定义 User Identiry：

  1.       namespace app;
  3. class User extends Object implements Authenticatable
  4. {
  5.     public static $users = [
  6.         ['id' => 1, 'name' => 'user1', 'password' => 'user1'],
  7.         ['id' => 2, 'name' => 'user2', 'password' => 'user2']
  8.     ];
  10.     public $id;
  11.     public $name;
  12.     public $password;
  14.     /**
  15.      * 通过用户的唯一标志查找用户，例如 主键、邮箱
  16.      */
  17.     public static function findIdentity($id)
  18.     {
  19.         if (is_numeric($id)) {
  20.             $key = 'id';
  21.             $value = $id;
  22.         } else if (is_array($id) && isset($id['name'])) {
  23.             $key = 'name';
  24.             $value = $id['name'];
  25.         } else {
  26.             throw new InvalidParamException("The param: id is invalid");
  27.         }
  29.         foreach (static::$users as $user) {
  30.             if ($user[$key] == $value) {
  31.                 return new static($user);
  32.             }
  33.         }
  34.     }
  36.     /**
  37.      * 返回该用户的 Auth ID，用于存储到 Session 中唯一标志这个用户
  38.      */
  39.     public function getAuthId()
  40.     {
  41.         return $this->id;
  42.     }
  44.     /**
  45.      * 检查用户的密码是否与用户输入相匹配
  46.      */
  47.     public function validatePassword($password)
  48.     {
  49.         return $this->password === $password;
  50.     }
  51. }
  52.

User Identity 定义好之后，我们需要配置 auth 服务，设置 model 属性告诉 auth 服务 User Identity 是怎样定义的：

  1.       'auth' => [
  2.     'class' => 'blink\auth\Auth',
  3.     'model' => 'app\User',
  4. ],
  5.

用户认证

只要 User Identity 定义并且配置好，我们就可以通过用户输入的用户名和密码来认证用户了，下面是例子：

  1.       $creditials = ['email' => 'foo@bar.com', 'password' => 123];
  3. // 通过给定的用户名和密码进行用户认证
  4. $user = auth()->attempt($creditials);
  6. // 进行用户认证但是不启用 Session
  7. $user = auth()->once($creditials);
  8.

如果采用 auth()->attempt() 来认证用户，auth 服务会利用 session 服务来为认证的用户存储必要的 Session 数据，所以我们需要配置好 session 服务以获取期望的结果。

用户授权

授权是检查一个用户具有足够权限做某事的过程，Blink 中，该功能由 blink\http\Request 类实现，下面是一个简单的例子：

  1.       use blink\core\Object;
  2. use blink\http\Request;
  4. class Controller extends Object
  5. {
  6.     public function actionFoo(Request $request)
  7.     {
  8.         if (!$requst->guest()) {
  9.             $user = $requst->user(); // 获取当前授权成功的用户
  10.         }
  11.     }
  12. }
  13.

目前，Blink 默认采用 X-Session-Id Http 头来传输 Session Id。当然，这也是可以配置的，我们可以通过设置blink\http\Request 的 sessionKey 属性来改变这个行为，关于如何设置该属性，请查看对应类实现的注释。