## 安裝配置文件
通過 `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',
],
],
```