如何监听Laravel会话生命周期结束时的Logout事件？

问题原因 #

Illuminate\Auth\Events\Logout 事件仅在用户主动调用登出方法（比如点击登出按钮触发Auth::logout()）时才会触发。当会话因生命周期到期自动失效时，Laravel不会主动触发该事件——因为这个过程是服务器端被动清理会话，没有经过认证系统的登出流程。

解决方案：数据库会话+定时任务处理过期会话 #

通过将会话存储到数据库，再定时清理过期会话并执行自定义逻辑，是最可靠的实现方式：

1. 配置数据库会话驱动

• 生成会话表迁移文件：

php artisan session:table

• 运行迁移创建会话表：

php artisan migrate

• 修改.env文件，将会话驱动改为database：

SESSION_DRIVER=database

2. 创建清理过期会话的Artisan命令

生成命令类：

php artisan make:command CleanExpiredSessions

替换命令类内容：

namespace App\Console\Commands;

use Illuminate\Console\Command;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Log;
use App\Models\User;

class CleanExpiredSessions extends Command
{
    protected $signature = 'sessions:clean-expired';
    protected $description = '清理过期会话并执行用户会话过期的自定义逻辑';

    public function handle()
    {
        // 计算会话过期时间点（当前时间减去会话生命周期分钟数）
        $expirationTimestamp = now()->subMinutes(config('session.lifetime'))->timestamp;
        
        // 查询所有已过期且关联了用户的会话
        $expiredSessions = DB::table('sessions')
            ->where('last_activity', '<', $expirationTimestamp)
            ->whereNotNull('user_id')
            ->get();

        foreach ($expiredSessions as $session) {
            // 执行你的自定义逻辑，比如记录日志、更新用户状态
            Log::debug("用户ID {$session->user_id} 因会话过期自动登出");
            
            // 示例：获取用户实例并处理业务逻辑
            $user = User::find($session->user_id);
            if ($user) {
                // 这里添加你的业务代码，比如标记用户为离线状态
                // $user->update(['is_online' => false]);
            }
        }

        // 调用Laravel内置命令彻底清理过期会话
        $this->call('session:clear');
    }
}

3. 配置定时任务

打开app/Console/Kernel.php，在schedule方法中注册定时任务：

protected function schedule(Schedule $schedule)
{
    // 每分钟执行一次清理任务（可根据需求调整频率）
    $schedule->command('sessions:clean-expired')->everyMinute();
}

确保你的服务器配置了Cron来运行Laravel的调度器：

* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1

其他说明 #

• 如果你的应用不需要精确到分钟级别的处理，可以降低定时任务的执行频率（比如每5分钟一次），减少服务器负载。
• 若使用Redis等其他会话驱动，可调整查询逻辑适配对应存储的会话数据结构，但核心思路一致：定时筛选过期会话并处理关联用户的逻辑。

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