Filament：修改导入功能默认表名及关联字段

• 自定义导入模型与表名
  Filament的导入功能依赖默认模型，需创建自定义版本指定新表名和关联字段：

  • 自定义Import模型：

    // app/Models/Import.php
    namespace App\Models;
    
    use Filament\Imports\Models\Import as BaseImport;
    use App\Models\User;
    
    class Import extends BaseImport
    {
        protected $table = 'mvl_imports';
    
        public function user()
        {
            return $this->belongsTo(User::class, 'mvl_user_id');
        }
    }
    

  • 自定义FailedImportRow模型：

    // app/Models/FailedImportRow.php
    namespace App\Models;
    
    use Filament\Imports\Models\FailedImportRow as BaseFailedImportRow;
    
    class FailedImportRow extends BaseFailedImportRow
    {
        protected $table = 'mvl_failed_import_rows';
    }
    

• 配置Filament使用自定义导入模型
  在AdminPanelProvider中指定自定义模型：

  // app/Providers/Filament/AdminPanelProvider.php
  use App\Models\Import;
  use App\Models\FailedImportRow;
  
  public function panel(Panel $panel): Panel
  {
      return $panel
          // ...其他原有配置
          ->imports([
              Import::class,
              FailedImportRow::class,
          ]);
  }
  

• 修改Job Batches与Notifications表前缀
  这两个表属于Laravel核心组件，需修改对应配置文件：

  • 队列Job Batches：编辑config/queue.php，修改batches表名：

    'batches' => [
        'table' => 'mvl_job_batches',
        'queue' => 'default',
    ],
    

  • Notifications表：编辑config/app.php，添加或修改notifications配置：

    'notifications' => [
        'table' => 'mvl_notifications',
    ],
    

• 调整迁移文件
  确保迁移文件使用新表名和字段：

  • mvl_imports迁移示例：

    Schema::create('mvl_imports', function (Blueprint $table) {
        $table->id();
        $table->string('type');
        $table->foreignId('mvl_user_id')->nullable()->constrained('mvl_users')->nullOnDelete();
        $table->integer('total_rows');
        $table->integer('successful_rows')->default(0);
        $table->integer('failed_rows')->default(0);
        $table->text('error')->nullable();
        $table->timestamps();
    });
    

  • mvl_failed_import_rows迁移示例：

    Schema::create('mvl_failed_import_rows', function (Blueprint $table) {
        $table->id();
        $table->foreignId('import_id')->constrained('mvl_imports')->cascadeOnDelete();
        $table->integer('row_index');
        $table->text('data');
        $table->text('error');
        $table->timestamps();
    });
    

  • mvl_job_batches和mvl_notifications：复制Laravel默认迁移文件，替换表名即可。

• 清除缓存并执行迁移
  执行命令确保配置生效：

  php artisan config:clear
  php artisan migrate # 生产环境建议单独运行新迁移，避免数据丢失
  

• 验证导入逻辑
  确保Resource中导入页面的配置没有硬编码表名，比如：

  public static function getPages(): array
  {
      return [
          'index' => Pages\ListUsers::route('/'),
          'create' => Pages\CreateUser::route('/create'),
          'edit' => Pages\EditUser::route('/{record}/edit'),
          'import' => Pages\ImportUsers::route('/import'),
      ];
  }
  

之前Laracasts方案失效，通常是因为未正确替换Filament默认导入模型或配置未加载。按上述步骤逐一排查，确保每个环节的表名和字段对应一致。

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