proxeuse / fortify-tabler

基于Tabler Bootstrap框架的FortifyUI预设。

v1.1.4 2021-02-13 20:02 UTC

This package is auto-updated.

Last update: 2024-09-22 17:39:38 UTC


README

Latest Stable Version Total Downloads PHP Version Support License

简介

Laravel 8有一个名为Jetstream的新且非常高效的脚手架包,但是许多用户不愿意学习新的框架(TailWind CSS)。幸运的是,Jetstream的后端已经以Fortify的名义提供。Fortify是一个无头身份验证后端,没有预配置的前端模板,这是它的一个缺点。FortifyUI通过添加缺少的功能来改进Fortify。

本包是FortifyUI的预设,它为最重要的页面提供了现成的、美观的模板,包括:登录、注册、密码重置页面以及双因素认证。在最新版本中,引入了头像和设备管理。这些模板基于并构建在Tabler.io框架之上,该框架使用Bootstrap 5.0构建。

此预设包括Tabler资产,用于版本1.0.0-alpha.21

安装

要开始使用,请使用composer安装此包。此命令还会安装FortifyUI,因此您无需先安装它。

composer require proxeuse/fortify-tabler

安装完成后,请使用以下PHP artisan命令运行安装程序。安装程序将引导您完成安装过程并询问您一些问题。

php artisan tabler:install

请勿忘记在安装成功后运行php artisan migrate命令!

更新说明

您可以使用内置的更新器执行某些更新。此更新器将尝试覆盖新版本中包含的某些文件。请注意,对那些文件所做的更改将被丢弃,您应确保您的更改是安全的。

首先,确保您已从仓库更新所有文件。这可以通过运行以下命令或通过将仓库内容复制到您的/vendor/proxeuse/fortify-tabler/文件夹来完成。

composer update

成功后,您应运行内置的更新命令。您可以选择几种不同的更新。

php artisan fortify:update

上述命令将更新所有文件,它的工作方式与--type=full命令相同。其他选项如下所示

将session驱动设置为数据库

此包具有一个功能,允许用户从其账户强制注销设备。为了使此功能正常工作,您需要将session驱动设置为数据库。这可以通过将.env文件中的SESSION_DRIVER变量更改为database来实现。文件的一部分如下所示。在此示例中,会话有效期设置为5天,而不是默认的2小时。

BROADCAST_DRIVER=log
CACHE_DRIVER=file
QUEUE_CONNECTION=sync
SESSION_DRIVER=database
SESSION_LIFETIME=7200

双因素认证

为了使双因素认证工作,您需要执行一些手动步骤。首先,从您的 /app/Providers/FortifyUIServiceProvider.php 文件中取消注释 Fortify::twoFactorChallengeView() 以注册视图。然后,前往 fortify.php 配置文件,确保 Features::twoFactorAuthentication 没有被取消注释。接下来,您需要更新您的用户模型以包含以下内容

use Laravel\Fortify\TwoFactorAuthenticatable;

class User extends Authenticatable
{
    use HasFactory, Notifiable, TwoFactorAuthenticatable;
    ...

邮件验证

要启用电子邮件验证功能,您需要访问 FortifyUI 服务提供者(/app/Providers/FortifyUIServiceProvider.php)并取消注释 Fortify::verifyEmailView() 以注册视图。然后,前往 fortify.php 配置文件,确保 Features::emailVerification() 没有被取消注释。接下来,您需要更新您的用户模型以包含以下内容

use Illuminate\Contracts\Auth\MustVerifyEmail;

class User extends Authenticatable implements MustVerifyEmail
{
    ...

这允许您将验证中间件附加到任何路由上。

密码确认

要启用密码确认功能,您需要访问 FortifyUI 服务提供者(/app/Providers/FortifyUIServiceProvider.php)并取消注释 Fortify::confirmPasswordView() 以注册视图。这允许您将 password.confirm 中间件附加到任何路由上。

更新用户资料和密码

要启用更新用户密码和/或个人资料信息的功能,请转到 fortify.php 配置文件,并确保这些功能没有被取消注释

Features::updateProfileInformation(),
Features::updatePasswords(),

屏幕截图

许可证

fortify-tabler 是开源软件,使用 MIT 许可证发布。查看许可证