Laravel Sanctum 的使用

重写默认模型

由于 laravel 自带的表名叫 personal_access_tokens ，开发中我们习惯用户表名叫 users，所以我们可以将表名修改为 user_tokens

1、创建 UserToken 模型文件

php artisan make:model UserToken

模型文件 UserToken.php内容如下：

<?php

namespace App\Models;

use Laravel\Sanctum\PersonalAccessToken as SanctumPersonalAccessToken;
use DateTimeInterface;

class UserToken extends SanctumPersonalAccessToken
{
	// 转换时间格式
    protected function serializeDate(DateTimeInterface $dateTime): string
    {
        return $dateTime->format('Y-m-d H:i:s');
    }
}

2、设置模型名称

在 app/Providers/AuthServiceProvider.php文件中，调用 usePersonalAccessTokenModel 方法设置访问令牌模型名称：

use App\Models\UserToken;
use Laravel\Sanctum\Sanctum;

/**
 * 引导应用程序服务。
 *
 * @return void
 */
public function boot()
{
    $this->registerPolicies();
	// 设置访问令牌模型名称
	Sanctum::usePersonalAccessTokenModel(UserToken::class);
}

这样重写默认模型就完成了

自定义验证

我们在实际开发中，验证规则可能会需要做一些自定义的操作，所以我们可以通过回调函数来进行自定义验证，里面的就可以写一些我们自定义的逻辑内容：

指定验证访问令牌的回调

在 app/Providers/AuthServiceProvider.php文件中，调用 authenticateAccessTokensUsing 方法指定验证访问令牌的回调

use App\Models\UserToken;
use Laravel\Sanctum\Sanctum;

/**
 * 引导应用程序服务。
 *
 * @return void
 */
public function boot()
{
    $this->registerPolicies();
    // 验证访问令牌的回调
	Sanctum::authenticateAccessTokensUsing(
		static function (PersonalAccessToken $accessToken, bool $isValid) {
			// 你的自定义逻辑
		}
	);
}

$accessToken为 token 信息，tokenable 包含了用户基本信息，token 过期时 tokenable 字段就不会再返回

$isValid为 token 有效状态，当 token 未过期时返回 true，否则就返回 false

自定义令牌有效期

Sanctum 可以在 config/sanctum.php配置文件中通过 expiration来设置过期时间，单位为分钟，但无法灵活地设置过期时间

1、设置短期令牌

（1）创建令牌时，对令牌设置令牌能力 server:limited：

$user->createToken('token-name', ['server:limited'])->plainTextToken;

（2）在 app/Providers/AuthServiceProvider.php文件中根据令牌能力设置过期时间：

如果令牌有效，就将 token 过期时间设置为自定义的过期时间，下面 now()->subMinutes(5) 表示有效期为 5 分钟

 public function boot()
 {
	 $this->registerPolicies();
	 // 验证访问令牌的回调
	 Sanctum::authenticateAccessTokensUsing(
		 static function (PersonalAccessToken $accessToken, bool $isValid) {
			 if (!$accessToken->can('server:limited')) {
				return $isValid;
			 }
			 return $isValid && $accessToken->created_at->gt(now()->subMinutes(5));
	 	}
	 );
 }

2、设置一次性访问令牌

（1）创建令牌时，对令牌设置令牌能力 server:once：

$user->createToken('token-name', ['server:once'])->plainTextToken;

（2）在 app/Providers/AuthServiceProvider.php文件中根据令牌能力设置过期时间：

如果令牌有效，并且未登陆过，就将 token 设置为失效，即可实现一次性令牌效果

 public function boot()
 {
	 $this->registerPolicies();
	 // 验证访问令牌的回调
	 Sanctum::authenticateAccessTokensUsing(
		 static function (PersonalAccessToken $accessToken, bool $isValid) {
			 if (!$accessToken->can('server:once')) {
				return $isValid;
			 }
			 return $isValid && $accessToken->last_used_at ===  null;
	 	}
	 );
 }

如有更好的使用技巧可以在评论留言讨论，如果好用我会更新到文章内