## 安装配置文件
通过 `php think topauth:install` 安装配置文件到 `config`目录下,文件名为`topauth.php`。
## 配置看守器
为了适用不同场景的用户认证,您在使用 `Lunzi\TopAuth\Auth` 门面时可通过 guard() 方法指定看守器。例如:
```
Auth::guard('api')->login($user);
```
```
Auth::guard('api')->check();
```
```
Auth::guard('api')->user();
```
### 默认看守器
扩展包默认了两个看守器:
* web 看守器
可用于 web 端用户认证
* api 看守器
可用于 api 场景的用户认证
### 增加看守器
您可以在 `topauth.php` 配置文件中的 `guards` 下增加看守器。
每个看守器需要指定驱动`driver`和用户提供者`provider`:
#### 目前可用的驱动 `driver` 有:
* session - 用于 web 端
* jwt - 用于 api 场景
## 配置用户提供者
提供者决定如何从数据库中检索用户。目前支持两个驱动:
### `model`驱动
提供一个模型来提供数据,如:
```
'providers' => [
'admin' => [
'driver' => 'model',
'model' => \app\model\Admin::class,
],
],
```
> 模型需继承 `\Lunzi\TopAuth\Models\User` 类,如:
```
<?php
namespace app\models;
class Admin extends \Lunzi\TopAuth\Models\User
{
protected $table = 'admins';
}
```
### `db`驱动
提供一个用户表名`table`来提供数据, 如:
```
'providers' => [
'admin' => [
'driver' => 'db',
'table' => 'admins',
],
],
```