yesccx/laravel-database-logger

record database execute logs

v1.2.1 2023-01-31 09:14 UTC

This package is auto-updated.

Last update: 2024-10-28 06:17:09 UTC


README

记录数据库MySQL、Mongo等执行日志,支持多数Laravel版本

目录

功能特点

  • 支持多数Laravel版本:Laravel 5+Laravel 6+Laravel 7+Laravel 8+Laravel 9+
  • 支持MongoDBMySQL产生的执行日志
  • 可选日志存储驱动filemysql,并支持自定义扩展
  • 更多API支持

运行环境

开始使用

1. 安装

composer require yesccx/laravel-database-logger:1.*

2. 初始化

发布配置文件,ServiceProvider等。

> php artisan database-logger:install

# Publishing Service Provider... [app/Provider/DatabaseLoggerProvider.php]
# Publishing Configuration... [config/database-logger.php]
# Database Logger installed successfully.

如果需要将日志记录到数据表中,还需要提前初始化对应的日志记录表

> php artisan database-logger:migration

# Publishing Migration... [database/migrations/2022_12_06_194505_create_database_logs_table.php]
# Migration created successfully!

> php artisan migrate --path=database/migrations/2022_12_06_194505_create_database_logs_table.php

3. 配置

env配置中开启记录器,并指定记录器的驱动。

PS: 如果以数据库驱动,需要先准备好数据表。在初始化时执行相关的迁移文件即可

> .env

# 日志记录总开关
DL_ENABLED=true

# 日志记录器 驱动类型
# file - 文件
# mysql - 数据库
DL_LOGGER_DRIVER=file

4. 使用

  • file 驱动时日志内容会存储至storage/logs/dl_sql-*.log文件中;
  • mysql 驱动时,日志内容会存储至database_logs数据表中。

API

临时禁用日志记录

如果想在某些情况下临时禁用日志记录功能,可以执行以下操作:

use Yesccx\DatabaseLogger\Services\DatabaseLoggerUtils;

DatabaseLoggerUtils::withoutLogger(function() {
    // 该闭包内执行的SQL语句将不会产生日志记录
    \App\Models\User::query()->first();
});

自定义记录器

当需要将日志内容以别的方式记录时,可以通过自定义记录器实现

1. 定义记录器:

namespace App\Services\DatabaseLogger;

use Yesccx\DatabaseLogger\Contracts\LoggerContract;
use Yesccx\DatabaseLogger\Supports\ResolvingResult;

class MongoLogger implements LoggerContract
{
    public function write(ResolvingResult $resolvingResult)
    {
        // 100ms 格式化的执行耗时
        $formatExecuteTime = $resolvingResult->getFormatExecuteTime();

        // 1000000 执行耗时(纳秒)
        $executeTime = $resolvingResult->getExecuteTime();

        // SELECT .... 执行的SQL语句
        $executeSql = $resolvingResult->getExecuteSql();

        // 编写存储逻辑
    }
}

2. 使用自定义记录器:

> .env

# 日志记录器 驱动类型
DL_LOGGER_DRIVER=App\Services\DatabaseLogger\MongoLogger

功能清单

  • 记录数据日志
  • 可选数据日志记录的存储驱动(file、mysql)
  • 赋于查询时可禁用日志记录功能
  • 赋于模型查询时直接打印SQL语句
  • 日志记录事件
  • 可视化面板查看日志
  • 补充更多API
  • 单元测试

License

MIT