Filament Admin中如何在isPaid字段修改时执行额外操作

我有一个包含多表的Filament Admin面板，已经生成了用于展示Orders的Resource。其中isPaid是默认值为false的布尔字段，请问当管理员将该字段设置为true时，在哪里可以添加额外执行的操作？

Migration文件 #

<?php
    
    use Illuminate\Database\Migrations\Migration;
    use Illuminate\Database\Schema\Blueprint;
    use Illuminate\Support\Facades\Schema;
    
    return new class extends Migration
    {
        /**
         * Run the migrations.
         */
    
        public function up(): void
        {
            Schema::create('orders', function (Blueprint $table) {
                $table->id();
                $table->string('name');
                $table->string('email');
                $table->string('tel');
                $table->integer('pax');
                $table->string('route');
                $table->string('pid');
                $table->string('price');
                $table->boolean('isPaid');
                $table->timestamps();   
            });
        }
    
        /**
         * Reverse the migrations.
         */
        public function down(): void
        {
            //
        }
    };

OrderResource文件 #

<?php

namespace App\Filament\Resources;

use App\Filament\Resources\OrderResource\Pages;
use App\Filament\Resources\OrderResource\RelationManagers;
use App\Models\Order;
use Filament\Forms;
use Filament\Resources\Form;
use Filament\Resources\Resource;
use Filament\Resources\Table;
use Filament\Tables;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\SoftDeletingScope;

class OrderResource extends Resource
{
    protected static ?string $model = Order::class;

    protected static ?string $navigationIcon = 'heroicon-o-collection';

    public static function form(Form $form): Form
    {
        return $form
            ->schema([
                Forms\Components\TextInput::make('name')
                    ->required()
                    ->maxLength(255),
                Forms\Components\TextInput::make('email')
                    ->email()
                    ->required()
                    ->maxLength(255),
                Forms\Components\TextInput::make('tel')
                    ->tel()
                    ->required()
                    ->maxLength(255),
                Forms\Components\TextInput::make('pax')
                    ->required(),
                Forms\Components\TextInput::make('route')
                    ->required()
                    ->maxLength(255),
                Forms\Components\TextInput::make('pid')
                    ->required()
                    ->disabled()
                    ->maxLength(255),
                Forms\Components\TextInput::make('price')
                    ->required()
                    ->maxLength(255),
                Forms\Components\Toggle::make('isPaid')
                    ->required(),
            ]);
    }

    public static function table(Table $table): Table
    {
        return $table
            ->columns([
                Tables\Columns\TextColumn::make('name'),
                Tables\Columns\TextColumn::make('email'),
                Tables\Columns\TextColumn::make('tel'),
                Tables\Columns\TextColumn::make('pax'),
                Tables\Columns\TextColumn::make('route'),
                Tables\Columns\TextColumn::make('pid'),
                Tables\Columns\TextColumn::make('price'),
                Tables\Columns\IconColumn::make('isPaid')
                    ->boolean(),
                Tables\Columns\TextColumn::make('created_at')
                    ->dateTime(),
                Tables\Columns\TextColumn::make('updated_at')
                    ->dateTime(),
            ])
            ->filters([
                //
            ])
            ->actions([
                Tables\Actions\EditAction::make(),
            ])
            ->bulkActions([
                Tables\Actions\DeleteBulkAction::make(),
            ]);
    }
    
    public static function getRelations(): array
    {
        return [
            //
        ];
    }
    
    public static function getPages(): array
    {
        return [
            'index' => Pages\ListOrders::route('/'),
            'create' => Pages\CreateOrder::route('/create'),
            'edit' => Pages\EditOrder::route('/{record}/edit'),
        ];
    }    
}

解决方案 #

根据不同的使用场景，有三种常用的实现方式：

1. 模型事件监听（全局生效） #

直接在Order模型中监听更新事件，只要isPaid从false变为true就执行操作，不管更新来源是Filament面板、API还是命令行：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Order extends Model
{
    protected static function booted()
    {
        static::updated(function (Order $order) {
            // 检测字段是否被修改，且修改后的值为true
            if ($order->isDirty('isPaid') && $order->isPaid) {
                // 在这里编写你的额外操作逻辑
                // 示例：发送支付确认邮件
                // Mail::to($order->email)->send(new PaymentConfirmation($order));
            }
        });
    }
}

2. Filament编辑页面钩子（仅后台面板生效） #

如果只想在Filament后台的编辑操作中触发，可以自定义Edit页面的更新逻辑：
首先生成Edit页面文件（如果未生成）：

php artisan make:filament-page EditOrder --resource=OrderResource

然后修改生成的EditOrder.php：

<?php

namespace App\Filament\Resources\OrderResource\Pages;

use App\Filament\Resources\OrderResource;
use Filament\Pages\Actions;
use Filament\Resources\Pages\EditRecord;

class EditOrder extends EditRecord
{
    protected static string $resource = OrderResource::class;

    protected function handleRecordUpdate($data): \Illuminate\Database\Eloquent\Model
    {
        $record = parent::handleRecordUpdate($data);
        
        // 检查提交的isPaid为true，且原记录的isPaid为false
        if ($data['isPaid'] && !$record->getOriginal('isPaid')) {
            // 执行你的额外操作
        }
        
        return $record;
    }

    protected function getActions(): array
    {
        return [
            Actions\DeleteAction::make(),
        ];
    }
}

3. 表单字段实时钩子（切换开关立即执行） #

如果需要用户切换isPaid开关时立即触发操作（无需等待表单提交），可以给字段添加实时监听：
修改OrderResource中的form方法：

Forms\Components\Toggle::make('isPaid')
    ->required()
    ->live() // 开启实时状态同步
    ->afterStateUpdated(function ($state, $record) {
        if ($state) {
            // 开关被打开时执行操作
            // 注意：此时记录尚未保存到数据库，需根据需求处理
        }
    }),

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