模型类型转换将迁移到 Laravel 11 中的方法

在 Laravel 10 中，模型类型转换是通过 $casts 数组属性定义的。然而，在 Laravel 11 中，你可以定义一个 casts() 方法，这为使用内置类型转换器上的静态方法以及为自定义类型转换器定义静态方法提供了可能性。

use App\Enums\UserOption;
use Illuminate\Database\Eloquent\Casts\AsEnumCollection;
 
// ...
 
/**
 * Get the attributes that should be cast.
 *
 * @return array<string, string>
 */
protected function casts(): array
{
    return [
        'email_verified_at' => 'datetime',
        'password' => 'hashed',
        'options' => AsEnumCollection::of(UserOption::class),
    ];
}

在 Laravel 10 中，由于在定义数组属性时无法调用静态方法，因此相同的类型转换看起来像下面这样。

protected $casts = [
    'options' => AsEnumCollection::class.':'.UserOption::class,
];

此更新与 Laravel 10 向后兼容，你仍然可以通过 $casts 属性和新的 casts() 方法来定义类型转换。$casts 属性和 casts() 方法将被合并，方法键优先于 $casts 属性。

如果你想利用内置类型转换器的静态方法，我建议将类型转换迁移到方法版本。

除了通过 casts() 方法定义类型转换的更新之外，还向内置类型转换器添加了新的静态方法，以简化类型转换的定义。

AsCollection::using(OptionCollection::class);
AsEncryptedCollection::using(OptionCollection::class);
AsEnumArrayObject::using(OptionEnum::class);
AsEnumCollection::using(OptionEnum::class);

感谢 Nuno Maduro，他在 Pull Request #47237 中实现了此功能！