vanthao03596 / fortify-limitless
由Fortify驱动的Laravel UI替代品
Requires
- php: ^7.4|^8.0
- illuminate/contracts: ^8.37
README
简介
FortifyLimitless 是一个无意见的认证启动器,由 Laravel Fortify 驱动。此包可用于启动您的项目,或者您可以使用 FortifyUi 预设模板,该模板允许您创建自己的预设,然后使用 FortifyUI 安装。
安装
要开始,您需要使用 Composer 安装 FortifyLimitless。这将安装 Laravel Fortify。
composer require vanthao03596/fortify-limitless
接下来,您需要运行安装命令
php artisan fortify-limitless
此命令将发布 FortifyLimitless 的视图,将 home
路由添加到 web.php
,并将 FortifyLimitless 服务提供程序添加到您的 app/Providers
目录。这将发布服务提供程序和配置文件 Laravel Fortify 的配置文件。最后,它将在 app.php
配置文件中的 providers 数组下注册这两个服务提供程序。
这就完成了!您已经全部设置好了!有关高级设置和配置选项,请继续阅读!
配置
编辑 FortifyUIServiceProvider
。
Fortify::loginView(function () { return view('auth.login'); }); Fortify::registerView(function () { return view('auth.register'); }); Fortify::requestPasswordResetLinkView(function () { return view('auth.forgot-password'); }); Fortify::resetPasswordView(function ($request) { return view('auth.reset-password', ['request' => $request]); }); // Fortify::verifyEmailView(function () { // return view('auth.verify-email'); // }); // Fortify::confirmPasswordView(function () { // return view('auth.confirm-password'); // }); // Fortify::twoFactorChallengeView(function () { // return view('auth.two-factor-challenge'); // });
要一次性注册所有视图,您可以使用以下命令
Fortify::viewPrefix('auth.');
现在,您应该已经有了所有注册的视图,包括 Laravel Fortify 所需的基本布局和主页视图,以及可选的密码确认、电子邮件验证和双因素认证视图。
特性
默认情况下,FortifyLimitless 设置为处理 Laravel Fortify 提供的基本认证功能(登录、注册、密码重置)。
电子邮件验证
要启用电子邮件验证功能,您需要访问 FortifyLimitless 服务提供程序,取消注释 Fortify::verifyEmailView()
以注册视图。然后,转到 fortify.php
配置文件并确保取消注释 Features::emailVerification()
。接下来,您需要更新您的 User
模型以包含以下内容
use Illuminate\Contracts\Auth\MustVerifyEmail; class User extends Authenticatable implements MustVerifyEmail { ...
这允许您将 verified
中间件附加到任何路由,由 verify.blade.php
文件处理。
密码确认
要启用密码确认功能,您需要访问 FortifyLimitless 服务提供程序,取消注释 Fortify::confirmPasswordView()
以注册视图。这允许您将 password.confirm
中间件附加到任何路由,由 password-confirm.blade.php
文件处理。
双因素认证
要启用双因素认证功能,您需要访问 FortifyLimitless 服务提供程序,取消注释 Fortify::twoFactorChallengeView()
以注册视图。然后,转到 fortify.php
配置文件并确保取消注释 Features::twoFactorAuthentication
。接下来,您需要更新您的 User
模型以包含以下内容
use Laravel\Fortify\TwoFactorAuthenticatable; class User extends Authenticatable { use HasFactory, Notifiable, TwoFactorAuthenticatable; ...
这就完成了!现在,您可以登录到您的应用程序并启用或禁用双因素认证。
更新用户密码/个人资料
要启用更新用户密码和/或个人资料信息的能力,请转到 fortify.php
配置文件并确保取消注释这些功能
Features::updateProfileInformation(), Features::updatePasswords(),
FortifyLimitless 预设
FortifyLimitless 鼓励您根据自己的喜好,使用喜欢的前端库和框架来创建自己的预设。要开始,请访问 Fortify UI Preset 模板 仓库,并点击“使用模板”按钮。
更新日志
有关最近更改的详细信息,请参阅 更新日志。
贡献
有关详细信息,请参阅 贡献指南。
安全漏洞
请查看我们的 安全策略 了解如何报告安全漏洞。
鸣谢
许可证
MIT 许可证(MIT)。有关更多信息,请参阅 许可证文件。