本教程深入探讨 Laravel 模型观察器的 `retrieved` 事件行为，并提供两种解决方案：使用 `Model::withoutEvents()` 精确禁用事件以避免不必要的日志记录，以及利用 Laravel 事件系统高效、解耦地记录用户 IP、User Agent 等活动数据到独立模型，从而实现更灵活、可维护的应用程序逻辑。
Laravel 的模型观察器（Observers）提供了一种优雅的方式来监听和响应 Eloquent 模型的生命周期事件，例如 created、updated、deleted 和 retrieved 等。它们将模型事件的处理逻辑集中管理，有助于保持模型本身的简洁性，并将相关业务逻辑从控制器或服务中解耦。
在提供的示例中，DictionaryObserver 监听了 Dictionary 模型的多个事件：
// app/Observers/DictionaryObserver.php
class DictionaryObserver
{
public function created(Dictionary $dictionary)
{
Log::info('yyyyyyyyy'); // 示例：创建时记录日志
}
public function retrieved(Dictionary $dictionary)
{
Log::info('xxxxxxxxxx'.$dictionary); // 示例：检索时记录日志
}
public function updated(Dictionary $dictionary)
{
// 处理模型更新事件
}
public function deleted(Dictionary $dictionary)
{
// 处理模型删除事件
}
}为了使观察器生效，需要在 App\Providers\AppServiceProvider 的 boot 方法中注册它：
// app/Providers/AppServiceProvider.php
use App\Models\Dictionary;
use App\Observers\DictionaryObserver;
use Illuminate\Pagination\Paginator; // 示例中包含
public function boot()
{
Paginator::useBootstrap(); // 示例中包含
Dictionary::observe(DictionaryObserver::class);
}retrieved 事件会在模型实例从数据库中被检索出来时触发。这意味着无论是通过 find() 获取单个模型，还是通过 get()、paginate() 获取模型集合，retrieved 事件都会为每一个被加载的模型实例触发一次。
问题描述： 用户希望 DictionaryObserver 中的 retrieved 方法只在编辑或查看单个字典记录时触发（例如，记录用户查看了某个具体记录的行为），但在列表页（index 方法）批量加载字典记录时禁用它，以避免不必要的日志记录或性能开销。
解决方案：使用 Model::withoutEvents() Laravel 提供了一个静态方法 Model::withoutEvents()，它允许你在一个回调函数内部执行 Eloquent 操作，而不会触发任何与该模型相关的事件（包括观察器和事件监听器）。这正是解决批量加载时禁用 retrieved 事件的理想方法。
示例代码：在控制器中应用 withoutEvents()
以下示例展示了如何在 DictionaryController 的 index 方法中利用 withoutEvents() 来避免批量加载时触发 retrieved 事件，同时确保在 show 方法中单独加载时事件正常触发。
// app/Http/Controllers/DictionaryController.php
<?php
namespace App\Http\Controllers;
use App\Models\Dictionary;
use Illuminate\Http\Request;
use App\Http\Resources\DictionaryResource; // 假设存在此资源
class DictionaryController extends Controller
{
protected $model;
public function __construct(Dictionary $model)
{
$this->model = $model;
}
public function index(Request $request)
{
// 使用 withoutEvents() 包装查询，确保在批量获取时不会触发 retrieved 事件
$dictionaries = Dictionary::withoutEvents(function () use ($request) {
$query = $this->model
->orderBy($request->column ?? 'created_at', $request->order ?? 'desc');
if ($request->search) {
$query->where(function ($q) use ($request) {
$q->where('name', 'like', '%' . $request->search . '%')
->orWhere('id', 'like', '%' . $request->search . '%');
});
}
return $query->paginate($request->per_page);
});
return DictionaryResource::collection($dictionaries);
}
// 对于单条记录的编辑或查看，例如 show 方法，则无需使用 withoutEvents()
// 这样 retrieved 事件会正常触发，达到记录单条访问的目的。
public function show(Dictionary $dictionary)
{
// 此处 $dictionary 会触发 retrieved 事件，因为没有使用 withoutEvents()
// DictionaryObserver 的 retrieved 方法会在此处被调用
\Log::info('用户查看了字典条目：' . $dictionary->id . ' - ' . $dictionary->name);
return new DictionaryResource($dictionary);
}
// ... 其他方法如 create, store 等
}工作原理：withoutEvents() 方法接受一个闭包作为参数。在该闭包内部执行的所有 Eloquent 操作，对于 Dictionary 模型而言，都不会触发其注册的观察器或事件监听器。一旦闭包执行完毕，事件系统将恢复正常，后续的 Eloquent 操作会继续触发事件。通过这种方式，我们可以精确控制 retrieved 事件的触发时机，使其仅在需要记录单个记录访问的场景下生效。
需求： 将用户 IP 地址、User Agent、当前登录用户 ID 和操作描述等信息保存到 Action 模型中，用于记录用户行为日志。
// app/Models/Action.php
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;
class Action extends Model
{
use SoftDeletes; // 假设有 ScopeActiveTrait，此处简化
protected $guarded = ['id'];
protected $fillable = [
'company_id',
'user_id',
'ip',
'user_agent',
'description'
];
protected $dates = [
'deleted_at',
'created_at',
'updated_at'
];
}获取用户活动信息：
实现方案：使用 Laravel 事件系统 (推荐) 为了实现业务逻辑的解耦和提高代码的可维护性，推荐使用 Laravel 的事件（Events）和监听器（Listeners）系统来记录用户活动。这种模式允许我们将日志记录逻辑从核心业务流程中分离出来。
步骤：
定义事件 (Event)：UserActionLogged 创建一个事件类来封装需要记录的用户活动数据。
php artisan make:event UserActionLogged
// app/Events/UserActionLogged.php
<?php
namespace App\Events;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;
class UserActionLogged
{
use Dispatchable, SerializesModels;
public $userId;
public $ipAddress;
public $userAgent;
public $description;
public $companyId; // 如果需要，可以添加
/**
* 创建一个新的事件实例。
*
* @param int|null $userId
* @param string $ipAddress
* @param string $userAgent
* @param string $description
* @param int|null $companyId
* @return void
*/
public function __construct($userId, $ipAddress, $userAgent, $description, $companyId = null)
{
$this->userId = $userId;
$this->ipAddress = $ipAddress;
$this->userAgent = $userAgent;
$this->description = $description;
$this->companyId = $companyId;
}
}定义监听器 (Listener)：LogUserAction 创建一个监听器类来处理 UserActionLogged 事件，并将数据保存到 Action 模型。
php artisan make:listener LogUserAction --event=UserActionLogged
// app/Listeners/LogUserAction.php
<?php
namespace App\Listeners;
use App\Events\UserActionLogged;
use App\Models\Action;
use Illuminate\Contracts\Queue\ShouldQueue; // 如果希望异步处理
use Illuminate\Queue\InteractsWithQueue;
class LogUserAction // implements ShouldQueue // 如果是异步处理，取消注释
{
// use InteractsWithQueue; // 如果是异步处理，取消注释
/**
* 处理事件。
*
* @param \App\Events\UserActionLogged $event
* @return void
*/
public function handle(UserActionLogged $event)
{
Action::create([
'company_id' => $event->companyId, // 根据实际情况传递或获取
'user_id' => $event->userId,
'ip' => $event->ipAddress,
'user_agent' => $event->userAgent,
'description' => $event->description,
]);
}
}注册事件和监听器 在 app/Providers/EventServiceProvider.php 文件的 $listen 属性中，将 UserActionLogged 事件与 LogUserAction 监听器关联起来。
// app/Providers/EventServiceProvider.php <?php namespace App\Providers; use Illuminate\Auth\Events\Registered; use Illuminate\Auth\Listeners\SendEmailVerificationNotification; use Illuminate\Foundation\Support\Providers\EventServiceProvider as ServiceProvider; use Illuminate\Support\Facades\Event;
以上就是Laravel 模型观察器与事件系统：精细化控制模型行为与用户活动日志的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
945
收藏
