本文旨在指导开发者如何在 Laravel 项目中使用 Sanctum 实现可选认证。通过检查请求中是否存在令牌，并根据令牌有效性来判断用户是否已登录，从而允许未登录用户访问特定路由，同时为已登录用户提供认证服务。
实现可选认证
在某些场景下，我们可能需要允许用户在未登录的情况下访问某些 API 接口，但如果用户已登录，则需要能够识别其身份。 使用 Laravel Sanctum，我们可以通过以下步骤实现这种可选认证：
1. 移除 auth:sanctum 中间件
首先，确保你的路由定义中没有使用 auth:sanctum 中间件。 该中间件会强制要求所有请求都必须提供有效的认证令牌，这与我们的可选认证需求相悖。
2. 检查请求中的令牌
在路由处理逻辑中，我们需要检查请求头中是否存在 Bearer 令牌。 Laravel 提供了 request()->bearerToken() 方法来获取令牌。
3. 尝试使用 Sanctum 认证用户
如果请求中存在令牌，我们尝试使用 Sanctum 认证守卫（auth.guard('sanctum')）获取用户信息。 如果令牌有效，则可以获取到已认证的用户实例；否则，将返回 null。
4. 设置当前用户
如果成功获取到用户实例，我们使用 Auth::setUser() 方法将其设置为当前用户。 这样，后续的 Auth::check() 和 Auth::user() 方法就可以正确地识别已登录用户。
5. 返回认证状态
最后，我们可以使用 Auth::check() 方法来判断用户是否已登录。 如果用户已登录（令牌有效），则返回 true；否则，返回 false。
示例代码
以下是一个示例代码，展示了如何在路由处理逻辑中实现可选认证：
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Route;
Route::get('optional-auth', function () {
if (request()->bearerToken() && $user = Auth::guard('sanctum')->user()) {
Auth::setUser($user);
}
return Auth::check(); // false for guest users, true if valid token present
});注意事项
- 确保你的 config/auth.php 文件中配置了 sanctum 认证守卫。
- 在使用 Auth::user() 方法之前，先使用 Auth::check() 方法判断用户是否已登录，以避免潜在的空指针异常。
- 对于需要特定权限的接口，仍然需要进行额外的权限验证。
总结
通过上述步骤，我们可以轻松地实现 Laravel Sanctum 的可选认证。 这种方法允许未登录用户访问特定路由，同时为已登录用户提供认证服务，从而提高应用程序的灵活性和用户体验。 记住，关键在于移除强制认证中间件，并在路由处理逻辑中手动检查和设置用户。
