Filament PHP中Toggle组件无法写入0/1数据到数据库的问题求助

以下是排查和解决的核心步骤：

• 检查数据库字段类型
  确保is_active字段为tinyint(1)或boolean类型（MySQL中tinyint(1)会被Eloquent视为布尔类型，与Filament Toggle的状态天然兼容）。如果字段是varchar或其他类型，会导致0/1无法正确存储。
  示例迁移代码：

  Schema::table('your_table', function (Blueprint $table) {
      $table->tinyInteger('is_active')->default(0);
  });
  

• 验证模型可填充属性
  必须在对应Eloquent模型的$fillable数组中添加is_active，否则Filament的表单批量赋值会被Eloquent的保护机制拦截，无法写入数据库。
  模型代码示例：

  class YourModel extends Model
  {
      protected $fillable = [
          // 其他字段...
          'is_active',
      ];
  }
  

• 兜底：手动映射Toggle状态（可选）
  若自动映射失效，可手动指定Toggle的读取和写入状态转换，确保输出为0/1：

  Toggle::make('is_active')
      ->onColor('success')
      ->offColor('danger')
      // 读取数据库值时转为布尔
      ->state(fn ($record) => (bool) $record->is_active)
      // 提交时转为0/1
      ->dehydrateStateUsing(fn ($state) => $state ? 1 : 0);
  

• 检查自定义提交逻辑
  如果你的Filament资源/页面重写了handleRecordCreation或handleRecordUpdate方法，要确保这些方法中没有遗漏is_active字段的处理，必须将该字段的值传入模型的保存逻辑中。

• 清除缓存
  执行以下命令清除应用缓存，避免缓存导致的字段映射异常：

  php artisan cache:clear
  php artisan view:clear
  

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