filament-auth-ui-enhancer 的安装和配置教程

1. 项目基础介绍和主要的编程语言

filament-auth-ui-enhancer 是一个开源项目，旨在增强 Laravel 的 Filament admin panel 的认证界面。该项目提供了更加美观和用户友好的登录、注册和密码重置界面。主要使用 PHP 作为后端编程语言，前端使用了 Laravel Mix 来编译和打包资源。

2. 项目使用的关键技术和框架

本项目基于以下技术和框架：

• Laravel: 一个流行的 PHP web 应用框架，提供了许多现代化的工具，用于快速开发强大的应用程序。
• Filament: 一个用于 Laravel 的开源后台面板，提供了许多构建后台所需的功能。
• Tailwind CSS: 一个功能类优先的 CSS 框架，用于快速UI开发。
• Laravel Mix: 一个提供流畅的 Webpack 编译的 Laravel 配置层的工具。

3. 项目安装和配置的准备工作及详细步骤

准备工作

在开始安装之前，请确保您的环境中已安装以下软件和扩展：

• PHP 7.3 或更高版本
• Composer
• Node.js 和 npm
• Laravel 和 Filament 的基础知识

安装步骤

1. 克隆项目到本地：

   git clone https://github.com/diogogpinto/filament-auth-ui-enhancer.git
   cd filament-auth-ui-enhancer
   

2. 安装项目依赖：

   composer install
   npm install
   

3. 配置 .env 文件，确保所有需要的 Laravel 配置都正确设置。

4. 发布配置文件和资源：

   php artisan vendor:publish --provider="Filketech\\FilamentAuthUiEnhancer\\FilamentAuthUiEnhancerServiceProvider"
   npm run dev
   

5. 运行数据库迁移：

   php artisan migrate
   

6. 运行以下命令以创建用户：

   php artisan make:admin AdminUser
   php artisan admin:create AdminUser
   

7. 将 Filament UI Enhancer 添加到路由中：

   打开 routes/web.php 文件，在 Route::group 中的 Route::get 和 Route::post 方法中添加以下代码：

   // 登录页面
   Route::get('/login', function () {
       return view('filament-auth-ui-enhancer::login');
   })->name('login');
   
   Route::post('/login', [LoginController::class, 'login']);
   
   // 注册页面
   Route::get('/register', function () {
       return view('filament-auth-ui-enhancer::register');
   })->name('register');
   
   Route::post('/register', [RegisterController::class, 'register']);
   
   // 密码重置页面
   Route::get('/password/reset', function () {
       return view('filament-auth-ui-enhancer::password');
   })->name('password.request');
   
   // 密码重置表单提交
   Route::post('/password/email', [ForgotPasswordController::class, 'sendResetLinkEmail'])->name('password.email');
   
   // 密码重置
   Route::post('/password/reset', [ResetPasswordController::class, 'reset'])->name('password.update');
   

8. 在 config/filament.php 文件中配置 Filament 以使用自定义的认证视图。

完成以上步骤后，您应该能够通过访问 /login、/register 或 /password/reset 来查看和测试自定义的认证界面了。