用途:在 Laravel 13 项目中实现用户认证、API 令牌、社交登录与授权。技能要求先并行调用三个 Agent(explore-codebase 检查现有 guards/policies、research-expert 通过 Context7 核对最新文档、mcp__context7__query-docs 查询具体模式),实现后用 sniper 校验。
主要能力:按需求选择方案——Starter Kits(新项目快速搭建)、Sanctum(API 令牌、SPA 认证)、Fortify(无头后端、自定义 UI、2FA)、Passport(OAuth2 服务端、第三方访问)、Socialite(Google、GitHub 等社交登录)。涵盖 guards、providers、gates、policies、token abilities 等概念,并提供登录控制器、策略类、Sanctum/Passport/Fortify 配置、密码重置、社交登录等模板,以及邮箱验证、会话、CSRF、加密与哈希等参考文档。
关键规则:模型授权用 policies 而非内联 if;密码用 Hash::make() 或 hashed 转换;登录后重新生成会话;生产环境使用 HTTPS;为令牌定义最小权限 abilities;限制登录频率并定期清理过期令牌。
FuseCore 集成:认证代码放在 /FuseCore/User/ 模块,策略放模块 App/Policies,路由放 User/Routes/api.php,Sanctum 配置放 User/Config/sanctum.php,其他模块在 module.json 声明 "User" 依赖,路由使用 auth:sanctum 中间件。
Laravel 13 变化:VerifyCsrfToken 更名为 PreventRequestForgery,通过 Sec-Fetch-Site 头做来源校验并回退到 CSRF 令牌;可用 preventRequestForgery(except: [...]) 排除路径,无状态 API(Sanctum 令牌)不受影响。
限制:资料未提供收费、价格、平台支持范围与效果数据;具体版本兼容性与安装命令暂未提供。