信息发布→ 登录 注册 退出

laravel如何实现用户操作日志记录_Laravel用户操作日志记录方法

发布时间:2025-09-30

点击量:
Laravel通过中间件、模型观察者或事件系统实现用户操作日志记录。首先使用中间件捕获POST、PUT、DELETE等请求,将用户IP、URL、输入数据等写入activity_logs表;其次利用模型观察者监听如Article的创建、更新、删除操作,记录具体数据变更;再结合自定义事件与监听器实现逻辑解耦,便于扩展与通知。日志表需包含user_id、ip、url、method、action、model等字段,并建立索引提升查询性能。核心是根据场景选择合适方式并避免记录敏感信息。

Laravel 实现用户操作日志记录,核心思路是捕获用户的请求行为并将其存储到数据库中。可以通过中间件、事件系统或模型观察者来实现,适用于后台管理、权限审计等场景。以下介绍几种实用且易于维护的实现方式。

使用中间件记录操作日志

中间件是记录用户操作最直接的方式,适合记录 HTTP 请求级别的行为,如访问了哪个路由、执行了什么操作。

创建一个日志中间件:

php artisan make:middleware LogUserActivity

在生成的中间件中添加记录逻辑:

app/Http/Middleware/LogUserActivity.php

public function handle($request, \Closure $next)
{
    $response = $next($request);

    // 只记录 POST、PUT、DELETE 等修改类请求
    if (in_array($request->method(), ['POST', 'PUT', 'DELETE'])) {
        \App\Models\ActivityLog::create([
            'user_id'     => auth()->id(),
            'ip_address'  => $request->ip(),
            'url'         => $request->fullUrl(),
            'method'      => $request->method(),
            'user_agent'  => $request->userAgent(),
            'input_data'  => json_encode($request->except(['password', 'password_confirmation'])),
            'status_code' => $response->getStatusCode(),
        ]);
    }

    return $response;
}

将中间件注册到 app/Http/Kernel.php 并应用到需要监控的路由组(如后台)。

通过模型观察者监听数据变更

如果需要记录具体的数据变化(如某条文章被修改),可以使用 Laravel 的模型观察者。

先创建模型和迁移:

php artisan make:model ActivityLog -m
php artisan make:observer ArticleObserver --model=Article

在观察者中记录操作:

class ArticleObserver
{
    public function created($article)
    {
        $this->log('created', $article);
    }

    public function updated($article)
    {
        $this->log('updated', $article);
    }

    public function deleted($article)
    {
        $this->log('deleted', $article);
    }

    private function log($action, $model)
    {
        ActivityLog::create([
            'user_id' => auth()->id(),
            'action'  => $action,
            'model'   => get_class($model),
            'model_id'=> $model->id,
            'data'    => $model->toJson(),
        ]);
    }
}

AppServiceProvider 中注册观察者:

Article::observe(ArticleObserver::class);

结合事件与监听器实现解耦

更灵活的方式是定义自定义事件和监听器,便于扩展和测试。

生成事件和监听器:

php artisan make:event UserActionLogged
php artisan make:listener SendLogNotification --queue

触发事件的地方(例如控制器中):

event(new UserActionLogged(auth()->user(), 'exported report', $request->ip()));

监听器中可写入数据库或发送通知,实现逻辑分离。

日志表结构建议

创建 activity_logs 表用于存储记录:

Schema::create('activity_logs', function ($table) {
    $table->id();
    $table->unsignedBigInteger('user_id')->nullable();
    $table->string('ip_address', 45)->nullable();
    $table->text('url')->nullable();
    $table->string('method')->nullable();
    $table->text('user_agent')->nullable();
    $table->text('input_data')->nullable();
    $table->integer('status_code')->nullable();
    $table->string('action')->nullable(); // 如 created, updated
    $table->string('model')->nullable();
    $table->unsignedBigInteger('model_id')->nullable();
    $table->json('data')->nullable();
    $table->timestamps();

    $table->index('user_id');
    $table->index('model');
    $table->index('model_id');
});

基本上就这些。根据项目复杂度选择合适的方式:中间件适合全局请求记录,观察者适合细粒度数据变更,事件系统适合高扩展性设计。关键是避免记录敏感信息(如密码),并合理索引数据库以提升查询效率。

标签:# http  # 后台管理  # 创建一个  # 数据库中  # 来实现  # 可以使用  # 几种  # 可以通过  # 适用于  # 器中  # 自定义  # laravel  # 数据库  # 事件  # delete  # 中间件  # 路由  # app  # json  # js  # word  # php  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!