首先安装 Filament:composer require filament/filament:^3.0,运行 php artisan filament:install --panels 并执行迁移,接着用 tinker 创建管理员用户,然后为模型(如 Blog)生成 Resource 以管理数据,最后在 Pages 中自定义表单和表格字段,快速搭建功能完整的后台。

Filament 是一个基于 Laravel 的现代化管理面板工具,能帮助开发者快速构建功能完整的后台管理系统。它使用 Livewire 和 Tailwind CSS,无需编写前端代码即可创建美观、响应式的管理界面。下面是一个实用的入门指南,教你如何在 Laravel 项目中使用 Filament 快速搭建管理后台。
安装 Filament 及其依赖
确保你已创建好 Laravel 项目(建议使用 Laravel 9 或以上版本)。接下来通过 Composer 安装 Filament:
- 运行命令:composer require filament/filament:^3.0
- 执行安装指令:php artisan filament:install --panels
- 该命令会发布必要的配置文件、迁移文件,并安装用户认证系统(利用 Laravel Fortify)
- 运行数据库迁移:php artisan migrate
创建管理员用户
Filament 默认使用 User 模型作为管理员账户。你可以用 Tinker 创建一个测试用户:
- 运行:php artisan tinker
- 输入代码:
User::factory()->create([ 'name' => 'Admin User', 'email' => 'admin@example.com', ])
- 保存后访问 /admin,使用该邮箱登录
生成资源(Resources)管理数据模型
Resource 是 Filament 中用于管理 Eloquent 模型的核心组件,比如你可以为 Blog 文章创建管理界面:
ECTouch是上海商创网络科技有限公司推出的一套基于 PHP 和 MySQL 数据库构建的开源且易于使用的移动商城网店系统!应用于各种服务器平台的高效、快速和易于管理的网店解决方案,采用稳定的MVC框架开发,完美对接ecshop系统与模板堂众多模板,为中小企业提供最佳的移动电商解决方案。ECTouch程序源代码完全无加密。安装时只需将已集成的文件夹放进指定位置,通过浏览器访问一键安装,无需对已有
- 先创建模型:php artisan make:model Blog -m
- 编辑迁移文件添加字段,如 title、content 等,然后运行 migrate
- 生成 Resource:php artisan make:filament-resource Blog
- 该命令会生成 BlogResource,包含 List、Create、Edit、View 四个页面类
- 完成后可在 /admin/blogs 中管理文章数据
自定义表单与表格字段
打开生成的 BlogResource/Pages/CreateBlog.php 和 EditBlog.php,可以在 form() 方法中定义表单字段:
- 常用字段类型:TextInput::make('title')、Textarea::make('content')、DateTimePicker::make('published_at')
- 在 Table 中定义展示列,如 Tables\Columns\TextColumn::make('title')
- 支持关系字段、状态开关、图片上传等高级功能(需配合 Spatie Media Library)
基本上就这些。Filament 的优势在于结构清晰、文档完善、扩展性强。你还可以添加 Widgets 显示统计图表,或通过 Pages 构建自定义页面。整个过程几乎不需要写前端代码,适合快速交付管理后台项目。









