如何在filament-authentication包中扩展角色资源添加额外字段？

1. 确认数据库字段生效 #

你已经在迁移文件里添加了新字段，先执行迁移让字段生效：

php artisan migrate

2. 自定义Role模型（别直接改vendor文件） #

插件自带的Role模型在vendor目录里，不能直接修改，我们自己建一个模型继承它：
在app/Models下新建Role.php：

<?php

namespace App\Models;

use FilamentUserRoleResourceManagement\Models\Role as BaseRole;

class Role extends BaseRole
{
    // 把你的新字段加到$fillable里，让Laravel允许批量赋值
    protected $fillable = [
        'name',
        'guard_name',
        'your_new_field', // 替换成你实际的字段名
        // 有多个新字段就继续加在这里
    ];
}

然后修改config/auth.php，把角色模型指向你刚建的自定义模型：

// config/auth.php
'providers' => [
    'users' => [
        'driver' => 'eloquent',
        'model' => App\Models\User::class,
    ],
    'roles' => [
        'driver' => 'eloquent',
        'model' => App\Models\Role::class, // 改成你的自定义模型
    ],
],

3. 创建自定义Role资源，添加字段到表单和列表 #

Filament的资源可以继承扩展，我们建自己的Role资源来覆盖插件的：
在app/Filament/Resources下新建RoleResource.php：

<?php

namespace App\Filament\Resources;

use FilamentUserRoleResourceManagement\Resources\RoleResource as BaseRoleResource;
use Filament\Forms\Components\TextInput; // 字段类型：文本输入框，按需换Textarea/Select等
use Filament\Forms\Form;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Table;

class RoleResource extends BaseRoleResource
{
    // 指定用我们的自定义Role模型
    protected static ?string $model = \App\Models\Role::class;

    // 扩展表单，追加新字段
    public static function form(Form $form): Form
    {
        // 先复用插件原有的表单字段，再加上我们的新字段
        return $form
            ->schema([
                ...parent::form($form)->getSchema(),
                TextInput::make('your_new_field')
                    ->label('你的字段名称') // 显示给用户的标签
                    ->required() // 可选：设置是否必填
                    ->maxLength(255), // 可选：限制字符长度
                // 有其他字段就继续在这里添加对应的组件
            ]);
    }

    // 扩展表格，在角色列表显示新字段
    public static function table(Table $table): Table
    {
        return $table
            ->columns([
                ...parent::table($table)->getColumns(),
                TextColumn::make('your_new_field')
                    ->label('你的字段名称')
                    ->sortable() // 可选：允许排序
                    ->searchable(), // 可选：允许搜索
                // 其他字段对应的表格列也加在这里
            ]);
    }
}

4. 替换插件默认资源，用我们的自定义资源 #

打开app/Providers/Filament/AdminPanelProvider.php，在面板配置里替换资源：

<?php

namespace App\Providers\Filament;

use Filament\Panel;
use Filament\PanelProvider;
use FilamentUserRoleResourceManagement\Resources\RoleResource as BaseRoleResource;
use App\Filament\Resources\RoleResource;

class AdminPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        return $panel
            ->default()
            ->id('admin')
            ->path('admin')
            // 这里保留你原有的其他配置，比如导航、认证等
            ->resources([
                // 过滤掉插件自带的Role资源
                ...collect($panel->getResources())->filter(fn ($resource) => $resource !== BaseRoleResource::class),
                // 注册我们的自定义Role资源
                RoleResource::class,
            ]);
    }
}

做完这些，刷新Filament后台的角色管理页面，就能看到新字段已经出现在表单和列表里了。如果需要更复杂的视图定制，可以在自定义资源里重写getCreateView()或getEditView()方法，指定自己的blade视图文件，但上面的步骤足够满足添加字段的需求。

内容的提问来源于stack exchange，提问作者Abhishek Kumar