如何在 ThinkPHP6 模型中写入自定义日志-ThinkPHP-PHP中文网

ThinkPHP6模型中写入自定义日志的核心是利用模型事件钩子（如afterInsert、afterUpdate、afterDelete）或手动调用Log门面，在关键操作节点记录结构化日志；可配置独立日志通道，避免与框架日志混杂。

如何在 thinkphp6 模型中写入自定义日志

在 ThinkPHP6 模型中写入自定义日志，核心是利用模型的事件钩子（如 afterInsert、afterUpdate、beforeDelete 等）或手动调用日志服务，在关键操作节点记录行为。不依赖第三方扩展，TP6 自带的日志驱动已足够灵活。

使用模型事件自动记录日志

ThinkPHP6 的模型支持生命周期事件，可在数据变更前后插入日志逻辑。需确保模型启用了事件支持（默认开启），并在模型类中定义对应方法：

在模型类中定义 afterInsert 方法，记录新增日志
定义 afterUpdate 方法，记录编辑日志
定义 afterDelete 方法，记录删除日志

示例（以 User 模型为例）：

app/model/User.php

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

namespace app\model;

use think\Model;
use think\facade\Log;

class User extends Model
{
    // 新增后写入日志
    public function afterInsert()
    {
        Log::info('用户创建', [
            'user_id' => $this->id,
            'username' => $this->username,
            'ip' => request()->ip(),
            'time' => date('Y-m-d H:i:s')
        ]);
    }

    // 更新后写入日志
    public function afterUpdate()
    {
        Log::info('用户资料更新', [
            'user_id' => $this->id,
            'update_fields' => $this->getChangedData(),
            'ip' => request()->ip()
        ]);
    }
}

手动在业务逻辑中调用日志服务

当需要更精细控制（如仅在特定条件、特定字段变更时记录），可在控制器或服务层中显式调用 think\facade\Log：

使用 Log::info()、Log::notice()、Log::error() 区分日志级别
日志内容建议结构化（数组），便于后续解析或对接 ELK 等系统
可结合 trace() 或 debug_backtrace() 记录调用栈（慎用，避免性能损耗）

示例：

app/controller/UserController.php

use think\facade\Log;

public function updateProfile()
{
    $user = User::find(input('id'));
    if ($user && $user->save(['nickname' => input('nickname')])) {
        Log::notice('用户昵称修改成功', [
            'user_id' => $user->id,
            'old_nickname' => $user->getOrigin('nickname'),
            'new_nickname' => input('nickname'),
            'operator' => session('admin_id') ?: 'unknown'
        ]);
        return success();
    }
    Log::error('用户昵称修改失败', ['input' => input()]);
    return fail();
}

为日志指定独立通道和配置

避免自定义日志混入框架默认日志，可在 config/log.php 中新增通道，例如：

config/log.php

'channels' => [
    'custom' => [
        'type' => 'File',
        'path' => __DIR__ . '/../runtime/log/custom/',
        'level' => 'info',
        'file_size' => 2097152, // 2MB
        'backup_num' => 10,
        'format' => '[%s][%s] %s %s',
    ],
],

然后在模型或控制器中使用该通道：

Log::channel('custom')->info('业务操作', [...]);

记录数据库原始 SQL（调试用）

若需追踪模型操作对应的 SQL，可启用查询日志并单独输出：

临时开启：在模型方法开头加 Db::startTrans(); Db::getLastSql(); 不适用；应改用监听器或中间件
推荐方式：在 app/common.php 或中间件中监听 think\db\Query 事件，捕获 QueryBefore 和 QueryAfter
简单调试：在模型事件中用 $this->getLastSql()（仅限当前查询，且需开启调试模式）

注意：生产环境避免长期记录完整 SQL，尤其含敏感参数时需脱敏处理。