Laravel Filament中如何实现表格列随月份选择动态响应更新？

问题原因 #

Filament默认会缓存getTableColumns()的返回值，因为框架默认假设表格列是静态结构。当你切换月份时，表单状态虽然即时更新，但表格列的缓存并未被清除，导致第一次切换时列仍使用旧的缓存数据；第二次切换时缓存才会更新，但此时读取的是上一次的月份状态，最终造成列与数据不同步的现象。而getTableQuery()每次请求都会重新执行，所以数据能正确加载。

解决方案 #

核心思路是：在表单月份选择变化时，主动清除表格列的缓存，强制框架重新计算列结构。

步骤1：将选中月份设为响应式属性

在自定义页面类中定义响应式属性，同步表单的月份选择：

public ?string $selectedMonth = null;

步骤2：修改表单字段，添加状态更新回调

在表单的month字段上启用live()，并在状态更新时同步属性、清除表格列缓存：

protected function getFormSchema(): array
{
    return [
        DatePicker::make('month')
            ->label('选择报表月份')
            ->month() // 返回YYYY-MM格式，若你用的是MM/YYYY可自行调整解析逻辑
            ->live()
            ->afterStateUpdated(function (string $state) {
                $this->selectedMonth = $state;
                // 清除表格列缓存，强制重新生成
                $this->table->forgetCachedColumns();
            })
            ->required(),
    ];
}

步骤3：调整getTableColumns()逻辑

基于响应式属性$selectedMonth生成动态列：

protected function getTableColumns(): array
{
    $columns = [
        TextColumn::make('name')
            ->label('员工姓名'),
    ];

    if (empty($this->selectedMonth)) {
        return $columns;
    }

    // 解析年月（根据你的表单格式调整，这里用YYYY-MM）
    list($year, $month) = explode('-', $this->selectedMonth);
    $date = new DateTime("$year-$month-01");
    $monthDays = (int) $date->format('t');
    
    for ($i = 1; $i <= $monthDays; $i++) {
        $columns[] = TextColumn::make("day$i")
            ->label($i)
            ->formatStateUsing(fn($state) => $state ? '出勤' : '缺勤');
    }

    return $columns;
}

替代方案：利用缓存依赖控制 #

如果你想更精细地控制缓存，可以重写cacheTableColumnsUsing()方法，让缓存依赖于选中月份：

protected function cacheTableColumnsUsing(): bool
{
    // 只有当选中月份存在时才缓存列，否则每次都重新生成
    return !is_null($this->selectedMonth);
}

这种方式配合live()字段的状态更新，也能实现列的动态刷新，但直接调用forgetCachedColumns()的方式更直接可靠。

内容的提问来源于stack exchange，提问作者Ján Janočko