Laravel模型事件允许在Eloquent模型生命周期的特定阶段执行自定义逻辑。1. 事件类型包括retrieved、creating、created、updating、updated、saving、saved、deleting、deleted、restoring、restored、forceDeleting、forceDeleted，其中creating、updating、deleting返回false可中断操作。2. 可在模型的boot方法中通过静态调用注册事件，如retrieved用于记录日志，creating用于生成UUID，updating检测字段变化，deleted清理关联数据。3. 推荐将复杂逻辑抽离至独立事件和监听器类，使用artisan命令创建后，在模型中触发事件并在EventServiceProvider中注册监听关系。4. 注意避免在事件中执行耗时操作，建议异步队列处理；retrieved事件可能影响性能；creating更适合设置默认值；软删除事件需启用SoftDeletes；批量操作不触发模型事件。合理使用可提升应用可维护性。
Laravel 模型事件是 Eloquent ORM 提供的一套强大的钩子机制，允许你在模型生命周期的特定时刻执行自定义逻辑。掌握这些事件有助于实现数据验证、日志记录、缓存清理、通知发送等功能。下面详细介绍 Laravel 模型事件的完整生命周期及其使用方式。
1. Laravel 模型事件类型
Laravel 支持多个模型事件，它们在模型操作的不同阶段触发：
- retrieved：从数据库中检索出模型后触发
- creating：创建新模型且即将保存时触发（red">此时模型尚未存入数据库）
- created：模型已成功插入数据库后触发
- updating：模型存在且即将更新时触发（可返回 false 阻止更新）
- updated：模型已成功更新后触发
- saving：模型即将保存（无论是新建还是更新）时触发
- saved：模型已保存（create 或 update）后触发
- deleting：模型即将被删除时触发（软删除也适用）
- deleted：模型已从数据库删除后触发
- restoring：软删除模型即将恢复时触发
- restored：软删除模型已恢复后触发
- forceDeleting：强制删除软删除模型时触发
- forceDeleted：模型被强制删除后触发
注意：creating / updating / deleting 事件中如果返回 false，将中断后续操作。
2. 如何注册模型事件
有多种方式可以监听模型事件，最常见的是在模型类中使用 static::boot() 方法。
示例：在 User 模型中监听事件
class User extends Model
{
protected static function boot()
{
parent::boot();
static::retrieved(function ($user) {
// 模型被检索后执行
\Log::info("User retrieved: {$user->id}");
});
static::creating(function ($user) {
// 创建前生成唯一编号
$user->uuid = (string) Str::uuid();
});
static::updating(function ($user) {
// 更新前检查字段变化
if ($user->isDirty('email')) {
$user->email_verified_at = null;
}
});
static::deleted(function ($user) {
// 删除用户后清理相关数据
$user->posts()->delete();
});
}
}
3. 使用事件类替代闭包（推荐做法）
当逻辑较复杂时，建议将事件处理抽离到独立的事件和监听器类中。
步骤：
- 使用 Artisan 命令创建事件和监听器：
php artisan make:event UserSavedphp artisan make:listener SendWelcomeEmail --event=UserSaved - 在模型中触发事件：
use App\Events\UserSaved;
class User extends Model
{
protected static function boot()
{
parent::boot();
static::saved(function ($user) {
event(new UserSaved($user));
});
}
}
然后在 EventServiceProvider 中注册监听关系：
protected $listen = [
'App\Events\UserSaved' => [
'App\Listeners\SendWelcomeEmail',
],
];
4. 常见使用场景与注意事项
模型事件非常实用，但也需注意以下几点：
- 避免在事件中进行耗时操作，考虑使用队列异步处理
- 慎用 retrieved 事件，频繁查询可能影响性能
- 在 creating 中设置默认值比在构造函数中更可靠
- 软删除相关事件（如 restoring, restored）仅在启用 SoftDeletes 时有效
- 批量操作（如 update()）不会触发模型事件，因为不加载模型实例
基本上就这些。理解模型事件的执行顺序和适用场景，能让你更好地控制数据行为，提升应用的可维护性。合理使用，不要过度依赖。
