laravel 是一个强大的 php 框架，为开发 web 应用程序提供了坚实的基础。 filament 是一个开源、优雅的 laravel 管理面板和表单构建器，可简化管理界面的创建。本指南将引导您使用最新版本的 filament 和 laravel 构建强大的管理面板。
laravel saas starter - 在一天而不是几周内启动您的下一个 saas
只需一天而不是几周即可启动您的下一个 laravel saas 项目！已经构建了每个 saas 都需要的功能
www.laravelsaas.store
先决条件
在我们开始之前，请确保您的开发计算机上安装了以下软件：
php >= 8.0
作曲家
node.js 和 npm
mysql 或 laravel 支持的任何其他数据库
第 1 步：设置新的 laravel 项目
首先，使用 composer 创建一个新的 laravel 项目：
composer create-project --prefer-dist laravel/laravel filament-admin cd filament-admin
接下来，设置环境变量。将 .env.example 文件重命名为 .env 并使用您的凭据更新数据库配置：
db_connection=mysql db_host=127.0.0.1 db_port=3306 db_database=filament_db db_username=root db_password=your_password
运行以下命令生成应用程序密钥并迁移默认的 laravel 表：
php artisan key:generate php artisan migrate
第 2 步：安装灯丝
要安装 filament，请使用 composer：
composer require filament/filament
接下来，发布 filament 资产和配置：
php artisan filament:install
第 3 步：设置身份验证
filament 需要身份验证才能管理对管理面板的访问。 laravel 提供内置的身份验证脚手架。为了简单起见，让我们使用 laravel breeze：
composer require laravel/breeze --dev php artisan breeze:install
按照提示选择您喜欢的前端选项（blade、vue、react）。在这个例子中，我们将使用 blade:
php artisan migrate npm install npm run dev
确保您有一个用户可以登录。您可以使用 laravel tinker 创建一个：
php artisan tinker >>> \app\models\user::factory()->create(['email' => 'admin@example.com']);
第 4 步：配置灯丝
如果您使用角色或权限，请更新用户模型以实现 filament hasfilamentroles 合约。目前，我们将确保任何经过身份验证的用户都可以访问 filament。
in app/providers/filamentserviceprovider.php, define the authorization logic:
use filament\facades\filament;
public function boot()
{
filament::serving(function () {
filament::registerusermenuitems([
'account' => menuitem::make()
->label('my account')
->url(route('filament.resources.users.edit', ['record' => auth()->user()]))
->icon('heroicon-o-user'),
]);
});
filament::registerpages([
// register your custom pages here
]);
filament::registerresources([
// register your custom resources here
]);
}
protected function gate()
{
gate::define('viewfilament', function ($user) {
return in_array($user->email, [
'admin@example.com',
]);
});
}
第 5 步：创建资源
filament 资源是具有 crud 接口的 eloquent 模型。让我们创建一个用于管理 post 模型的资源。
生成模型、迁移和工厂：
php artisan make:model post -mf
定义迁移文件中的字段：
public function up()
{
schema::create('posts', function (blueprint $table) {
$table->id();
$table->string('title');
$table->text('content');
$table->timestamps();
});
}
运行迁移：
php artisan migrate
接下来，生成filament资源：
php artisan make:filament-resource post
此命令为资源创建必要的文件。打开 app/filament/resources/postresource.php 并定义资源字段：
use filament\resources\pages\page;
use filament\resources\pages\createrecord;
use filament\resources\pages\editrecord;
use filament\resources\pages\listrecords;
use filament\resources\forms;
use filament\resources\tables;
use filament\resources\forms\components\textinput;
use filament\resources\forms\components\textarea;
use filament\resources\tables\columns\textcolumn;
class postresource extends resource
{
protected static ?string $model = post::class;
protected static ?string $navigationicon = 'heroicon-o-collection';
public static function form(form $form): form
{
return $form
->schema([
textinput::make('title')
->required()
->maxlength(255),
textarea::make('content')
->required(),
]);
}
public static function table(table $table): table
{
return $table
->columns([
textcolumn::make('title'),
textcolumn::make('content')
->limit(50),
textcolumn::make('created_at')
->datetime(),
]);
}
public static function getpages(): array
{
return [
'index' => pages\listrecords::route('/'),
'create' => pages\createrecord::route('/create'),
'edit' => pages\editrecord::route('/{record}/edit'),
];
}
}
第 6 步：添加导航
将资源添加到 filament 侧边栏。打开 app/providers/filamentserviceprovider.php 并注册资源：
use app\filament\resources\postresource;
public function register()
{
filament::registerresources([
postresource::class,
]);
}
第 7 步：定制灯丝
灯丝是高度可定制的。您可以更改主题、组件等。例如，要自定义原色，请更新 config/filament.php 文件：
'brand' => [
'primary' => '#1d4ed8',
],
您还可以按照文档创建自定义页面、小部件和表单组件：filament 文档。
laravel saas starter - 在一天而不是几周内启动您的下一个 saas
只需一天而不是几周即可启动您的下一个 laravel saas 项目！已经构建了每个 saas 都需要的功能
www.laravelsaas.store
结论
在本指南中，我们逐步介绍了设置新的 laravel 项目、安装 filament、设置身份验证、创建资源以及自定义 filament 管理面板。这将为您使用 filament 和 laravel 构建强大的管理面板奠定坚实的基础。如需更多高级功能和定制，请参阅官方文档并探索 filament 的功能。
编码愉快！
