Filament 是基于 Laravel 的组件化后台框架，需 Laravel 10+ 和 PHP 8.1+，安装后必须执行 php artisan filament:install --panels 并手动实现 CanAccessPanel 接口、注册资源、清配置缓存。
Filament 不是“装上就能用”的后台模板，它是基于 Laravel 的组件化后台框架，安装本身简单，但真正能用起来、不踩坑，关键在理解它的架构分层和权限绑定逻辑。
composer require filament/filament:~3.0 是基础，但必须配合 Laravel 10+ 和 PHP 8.1+
Filament v3 要求 Laravel 版本 ≥ 10.0，PHP ≥ 8.1。如果你用的是 Laravel 9 或更低版本，强行安装会触发 composer 冲突或运行时 TypeError（比如 Attribute::getArguments() 不存在）。官方已停止对 v2 的维护，别试图降级 Filament 来适配旧项目。
执行命令前确认环境：
php -v
php artisan --version
然后运行：
composer require filament/filament:"~3.0"
之后必须立即执行：
php artisan filament:install --panels
这个命令会生成 app/Providers/Filament/AdminPanelProvider.php 并注册进 config/app.php，漏掉这步，后续所有 php artisan make:filament... 命令都会报错 Class "App\\Providers\\Filament\\AdminPanelProvider" not found。
php artisan make:filament-resource User 生成的代码不能直接跑
该命令只生成骨架文件（app/Filament/Resources/UserResource.php、app/Filament/Resources/UserResource/Pages/ListUsers.php 等），不会自动注册路由或关联模型字段。常见错误包括：
-
Call to undefined method App\Models\User::getFilamentTableColumns()—— 忘了在User模型里加use Filament\Panel\Traits\HasFilamentTableColumns; - 列表页空白或报
Undefined array key "name"——UserResource::getTableColumns()返回的列里用了未定义的访问器，比如写了TextColumn::make('name')，但模型没有$fillable或访问器支持 - 编辑页保存失败且无提示 —— 默认没启用
SoftDeletes但数据库字段有deleted_at，需在form()中显式排除：Hidden::make('deleted_at')
建议第一步先手动补全模型契约：
fs-company v1.1.1 是由佛山网基网络工作室开发的基于Asp+Access+IIs架构的快速搭建企业网站的程序，是fs-company_V1.1.0_sc_gbk的新版本。该程序完全免费，没有功能限制，欢迎大家使用它搭建网站。后台路径：/company/admin默认管理员：admin82 密码：admin82fs-company企业网站系统特性1、易用性 (1) 主题模板安装使
use Filament\Panel\Traits\HasFilamentTableColumns;
class User extends Authenticatable
{
use HasFilamentTableColumns;
}
Auth 用户必须实现 CanAccessPanel 接口才能登录后台
Filament 默认只允许实现了 CanAccessPanel 接口的用户进入 /admin。这不是配置项，是硬性检查。如果你沿用 Laravel 自带的 User 模型，它默认不实现该接口，结果就是：登录成功，跳转到 /admin 后直接 403。
解决方式只有两种：
- 在
User模型中添加implements CanAccessPanel，并实现canAccessPanel()方法（返回true或按角色判断） - 或者改用 Filament 提供的
App\Models\Admin类（需手动创建），让它继承Model并实现接口，再把后台登录指向这个模型（修改config/filament.php中的'auth.model'）
最简调试法（仅开发阶段）：
use Filament\Panel\Contracts\CanAccessPanel;
class User extends Authenticatable implements CanAccessPanel
{
public function canAccessPanel(): bool
{
return $this->email === 'admin@example.com';
}
}
资源注册后仍看不到菜单？检查 config/filament.php 的 panels 配置
生成的 UserResource 不会自动出现在左侧菜单，必须手动注册到 config/filament.php 的 'resources' => [] 数组里，例如：
'resources' => [
\App\Filament\Resources\UserResource::class,
],
但更常见的问题是：你改了 config/filament.php 却没清缓存。Laravel 会缓存配置，导致修改不生效。每次改完必须运行：
php artisan config:clear
另外注意路径大小写 —— Windows 下可能不敏感，Linux 服务器上 App\Filament\Resources\userresource::class（小写 u）会直接报 Class not found，必须严格匹配命名空间和文件名。
真正卡住人的从来不是安装命令，而是资源类里的 getRelations() 返回空数组却没意识到要手动加 BelongsTo 字段，或是 Table::make() 里用了 ToggleColumn 却忘了模型对应字段是布尔类型而非字符串。这些细节不报错，只让功能静默失效。
