🎤 Laravel 模型观察者：参数传递策略与动态修改机制的趣味讲座
大家好！欢迎来到今天的 Laravel 技术分享会 🎉。今天我们要聊的是一个非常有趣的话题——模型观察者（Model Observers）。如果你觉得这听起来有点高深莫测，别担心！我会用轻松诙谐的语言，加上代码和表格，带你一步步了解它的奥秘。
🔍 什么是模型观察者？
在 Laravel 中，模型观察者就像一个忠实的小助手，它会在你的 Eloquent 模型触发某些事件时自动跳出来帮你干活。比如，当模型被创建、更新或删除时，观察者就会执行你定义的操作。
举个例子：假设你有一个 User 模型，每当有新用户注册时，你想自动发送一封欢迎邮件。这时候，观察者就派上用场了！
namespace AppObservers;
use AppModelsUser;
use IlluminateSupportFacadesMail;
class UserObserver
{
public function created(User $user)
{
Mail::to($user->email)->send(new WelcomeEmail());
}
}简单吧？但你知道吗，这个小助手背后还有很多有趣的秘密！接下来，我们就来深入探讨两个核心问题：
- 观察者方法的参数传递策略
- 如何动态修改观察者的行为
📦 参数传递策略：观察者接收到的是什么？
当你定义一个观察者方法时，Laravel 会自动将相关的模型实例作为参数传递给你。例如，在上面的 created 方法中，$user 就是刚刚创建的 User 模型实例。
观察者支持的事件类型
Laravel 提供了以下事件类型供观察者监听：
| 事件名称 | 调用时机 |
|---|---|
retrieved |
模型从数据库中检索后立即调用 |
creating |
在模型保存到数据库之前调用 |
created |
在模型成功保存到数据库之后调用 |
updating |
在模型更新之前调用 |
updated |
在模型成功更新之后调用 |
saving |
在模型保存（无论是插入还是更新）之前调用 |
saved |
在模型成功保存之后调用 |
deleting |
在模型删除之前调用 |
deleted |
在模型成功删除之后调用 |
restoring |
在模型从软删除状态恢复之前调用 |
restored |
在模型成功恢复之后调用 |
参数传递的秘密
无论哪个事件，Laravel 都会将当前的模型实例作为唯一的参数传递给观察者方法。例如：
public function updating(User $user)
{
// $user 是即将更新的模型实例
if ($user->isDirty('email')) {
// 如果邮箱字段发生了变化
Log::info("用户 {$user->id} 更改了邮箱");
}
}🌟 注意：
isDirty()方法可以用来检查某个字段是否发生了变化。
🔄 动态修改观察者行为：灵活应对需求变化
有时候，我们的业务逻辑可能会根据不同的场景动态调整观察者的行为。比如，我们可能希望在特定条件下才发送欢迎邮件，或者根据用户的角色执行不同的操作。
方法一：使用条件判断
最简单的方式是在观察者方法中直接添加条件判断。例如：
public function created(User $user)
{
if ($user->role === 'admin') {
Mail::to($user->email)->send(new AdminWelcomeEmail());
} else {
Mail::to($user->email)->send(new WelcomeEmail());
}
}方法二：通过服务容器注入依赖
如果你需要更复杂的逻辑，可以通过 Laravel 的服务容器注入依赖。例如：
namespace AppObservers;
use AppModelsUser;
use IlluminateSupportFacadesApp;
class UserObserver
{
protected $emailer;
public function __construct(EmailerService $emailer)
{
$this->emailer = $emailer;
}
public function created(User $user)
{
$this->emailer->sendWelcomeEmail($user);
}
}在这个例子中，EmailerService 是一个自定义的服务类，负责处理邮件发送的具体逻辑。通过这种方式，我们可以将观察者的职责保持单一，同时让业务逻辑更加灵活。
方法三：动态注册观察者
如果你希望在运行时动态决定是否注册某个观察者，可以通过 Model::observe() 方法手动控制。例如：
if (config('app.send_welcome_emails')) {
User::observe(UserObserver::class);
}这样，只有在配置文件中启用了 send_welcome_emails 选项时，UserObserver 才会被注册。
🛠 实战演练：动态修改模型属性
假设我们有一个需求：在用户更新资料时，如果他们更改了密码，我们需要强制要求他们重新登录。我们可以利用观察者来实现这个功能。
步骤 1：创建观察者
namespace AppObservers;
use AppModelsUser;
class UserObserver
{
public function updated(User $user)
{
if ($user->wasChanged('password')) {
$user->forceLogout();
}
}
}步骤 2：在模型中定义 forceLogout 方法
namespace AppModels;
use IlluminateDatabaseEloquentModel;
class User extends Model
{
public function forceLogout()
{
// 清除用户的会话信息
auth()->logout();
Log::info("用户 {$this->id} 因为密码变更被强制登出");
}
}步骤 3：注册观察者
在 AppServiceProvider 或其他合适的地方注册观察者：
namespace AppProviders;
use AppModelsUser;
use AppObserversUserObserver;
use IlluminateSupportFacadesApp;
use IlluminateSupportServiceProvider;
class AppServiceProvider extends ServiceProvider
{
public function boot()
{
User::observe(UserObserver::class);
}
}🎯 总结
通过今天的分享，我们了解了以下内容：
- 观察者方法的参数传递策略：Laravel 会将当前的模型实例作为唯一参数传递给观察者方法。
- 动态修改观察者行为：可以通过条件判断、服务容器注入依赖、以及动态注册观察者等方式实现灵活的行为调整。
希望这篇文章能让你对 Laravel 模型观察者有更深入的理解！如果你有任何疑问或想法，欢迎在评论区留言 💬。
最后，别忘了给这篇文章点个赞 👍，让我们下次再见！👋
