Laravel中如何实现用户首次登录时展示欢迎弹窗并记录状态

核心错误修正 #

你当前的控制器逻辑存在关键问题：首次登录时未将first_login字段改为false，导致每次登录都会触发欢迎消息。以下是修正后的完整代码与流程：

1. 修正控制器代码

<?php

namespace App\Http\Controllers;

use Auth;
use Illuminate\Http\Request;

class FirstLoginController extends Controller
{
    public function showWelcomeModal()
    {
        $user = Auth::user();
        $firstLogin = false;

        if ($user->first_login) {
            $firstLogin = true;
            // 标记为已完成首次登录，后续登录不再触发
            $user->first_login = false;
            $user->save();
        }

        return view('test', ['first_login' => $firstLogin]);
    }
}

• 调整了类名与方法名，符合PHP PSR规范
• 首次登录后将first_login设为false，确保仅触发一次

2. 衔接登录流程

在默认的LoginController中重写authenticated方法，控制登录后的跳转逻辑：

protected function authenticated(Request $request, $user)
{
    // 首次登录跳转到欢迎模态页，否则跳转到默认首页
    if ($user->first_login) {
        return redirect()->route('first.login');
    }
    return redirect()->intended('/');
}

同时在routes/web.php中添加路由：

Route::get('/first-login', [FirstLoginController::class, 'showWelcomeModal'])->name('first.login')->middleware('auth');

3. 实现模态框视图（以Bootstrap为例）

替换你的示例视图为实际可交互的模态框：

<!DOCTYPE html>
<html>
<head>
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
</head>
<body>
    <h1>应用首页</h1>

    <!-- 首次登录欢迎模态框 -->
    @if ($first_login)
    <div class="modal fade show" tabindex="-1" style="display: block; background-color: rgba(0,0,0,0.5);">
        <div class="modal-dialog">
            <div class="modal-content">
                <div class="modal-header">
                    <h5 class="modal-title">🎉 欢迎加入！</h5>
                    <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
                </div>
                <div class="modal-body">
                    <p>感谢您注册我们的应用，祝您使用愉快！</p>
                </div>
                <div class="modal-footer">
                    <button type="button" class="btn btn-primary" data-bs-dismiss="modal">开始探索</button>
                </div>
            </div>
        </div>
    </div>
    @endif

    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
</body>
</html>

关于登出的疑问解答 #

完全不需要在登出时更新first_login字段。首次登录时我们已经将该字段设置为false，后续无论用户登出多少次，再次登录时first_login始终为false，不会重复触发欢迎模态框。

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