Filament v5 小白教程常用操作

type

Post

status

Published

date

May 14, 2026

slug

summary

Filament v5 小白教程 - 常用操作

📘

写给谁看？刚接触 Filament 的新手，看完能自己搭一个后台。

什么是 Filament？

Filament 是 Laravel 的 后台面板框架。简单说：用 PHP 代码就能生成管理后台，不用写 HTML/CSS/JavaScript。

一、安装

创建项目

安装 Filament

创建管理员账号

启动看看效果

浏览器打开 http://localhost:8000/admin，用刚才创建的账号登录。

✅

成功了！看到后台界面了？全是 Filament 自动生成的，一行前端代码都没写。

二、结构理解

Filament 项目主要文件都在 app/Filament/ 目录下：

配置文件在 app/Providers/Filament/AdminPanelProvider.php

三、创建第一个功能（文章管理）

📘

完整流程建模型 → 跑迁移 → 建 Filament 资源 → 生成权限

1. 创建模型 + 迁移

打开 database/migrations/..._create_posts_table.php，写字段：

2. 创建 Filament 资源

这是最核心的命令，它会自动生成：

PostResource.php — 资源主文件

Schemas/PostForm.php — 表单配置

Tables/PostsTable.php — 表格配置

Pages/ — 列表/创建/编辑页面

3. 配置表单（编辑时显示什么字段）

打开 app/Filament/Resources/Posts/Schemas/PostForm.php：

4. 配置表格（列表显示什么列）

打开 app/Filament/Resources/Posts/Tables/PostsTable.php：

5. 刷新页面看看

http://localhost:8000/admin/posts — 现在可以增删改查文章了。

四、常见表单字段

💡

记不住的直接复制

五、常见表格列

状态徽章颜色

六、过滤器

七、修改导航菜单

常用图标：

Heroicon::OutlinedUsers — 用户

Heroicon::OutlinedDocumentText — 文章

Heroicon::OutlinedTag — 分类

Heroicon::OutlinedShoppingCart — 订单

Heroicon::OutlinedCube — 产品

Heroicon::OutlinedCog6Tooth — 设置

Heroicon::OutlinedPhoto — 图片

八、安装插件

常用的免费插件：

包名	作用
`bezhansalleh/filament-shield`	角色权限管理
`jeffgreco13/filament-breezy`	个人资料/2FA
`pxlrbt/filament-excel`	表格导出 Excel
`awcodes/filament-curator`	媒体库管理
`opcodesio/log-viewer`	后台看日志
`joaopaulolndev/filament-general-settings`	系统配置界面

九、常见问题

Q: 修改了代码页面没变化？

Q: Storage 图片看不到？

Q: 界面报错 Class not found？

Q: 新增了 Resource 但菜单没有？

Filament 会自动发现资源，刷新即可。如果还是不行：

Q: 编辑时密码不想必填？

十、完整示例：产品管理

💬

Filament 的核心思路：配表单、配表格、搞定 CRUD。其他功能都是在这基础上加的选项。