如何在Laravel中手动为auth()设置指定的已登录用户

即便你没有使用Laravel自带的注册、登录验证等身份验证功能，只要项目保留了默认的Auth服务提供者配置，就可以通过内置方法手动设置登录态，让auth()->user()正常读取到对应用户信息：

适用前提 #

你拿到的目标用户实例必须实现了Illuminate\Contracts\Auth\Authenticatable契约，Laravel默认生成的User模型已经自带该实现，无需额外修改。

常用实现方法 #

1. 已有完整用户实例时使用login()方法 #

这是最常用的方案，设置后登录态会通过Session持久化到后续请求：

// $user 是你提前获取到的目标用户实例
auth()->login($user);

// 如需开启"记住我"功能，传入第二个参数即可
auth()->login($user, true);

设置完成后直接调用auth()->user()即可读取到该用户信息。

2. 仅持有用户ID时使用loginUsingId()方法 #

不需要查询用户实例，直接通过用户ID设置登录态：

// $userId 为目标用户的主键ID
auth()->loginUsingId($userId);

// 同样支持记住我参数
auth()->loginUsingId($userId, true);

3. 仅当前请求临时生效的设置方案 #

如果不需要登录态持续到后续请求，不需要生成Session和Cookie，可以使用一次性登录方法：

// 用用户ID设置当前请求登录态
auth()->onceUsingId($userId);

// 也可以传入其他用户唯一字段匹配
auth()->once(['email' => 'user@example.com']);

注意事项 #

• 如果你使用了自定义Guard，调用时需要指定Guard名称，例如后台Guard为admin时写法为：auth()->guard('admin')->login($user)
• 自定义用户模型需要确保完整实现Authenticatable契约的所有方法，否则上述调用会报错
• 设置完成后可以调用auth()->check()验证是否生效，返回true则说明登录态设置成功

内容的提问来源于stack exchange，提问作者Axel