logger 日志统筹化管理插件

v2.0.1 版本

2024-08-07 版本更新时间

794 安装

5 star

https://github.com/webman-tech/logger

为了后期更好的维护，最新 2.0 版本已修改包名，请注意切换

webman-tech/logger

webman log 统筹化管理插件

简介

webman 支持原始的 monolog 配置形式，配置灵活，但是从以下情况来看不是特别便利：

当日志特别多，不可能所有日志都通过 Log::info 的形式去记录，肯定是需要分 channel 的
当 channel 特别多的时候：每个都要去单独定义，但基本都是复制粘贴的，当后期切换所有通道写入渠道时，需要逐一修改，不太好维护
每次通过 Log::channel('channelName') 的形式去调用，因为 channelName 是字符串，万一单词拼错，会导致日志记录不到
没有很好的利用好 monolog 的 formatter 和 processor

此插件即为了解决以上问题，针对多 channel 模式进行统筹优化管理

安装

composer require webman-tech/logger

配置

主要的配置文件位于：config/plugin/webman-tech/logger/log-channel.php，按需调整，后文详细对其中部分配置做说明
（建议）自定义一个 Logger 类继承 WebmanTech\Logger\Logger，比如 support\facade\Logger，便于后期扩展和使用
（必须）在 config/log.php 中合并原来的配置和 Logger::getLogChannelConfigs()，例如：

use support\facade\Logger;

return array_merge(
    [
        'default' => [
            'handlers' => [
                [
                    'class' => Monolog\Handler\RotatingFileHandler::class,
                    'constructor' => [
                        runtime_path() . '/logs/webman.log',
                        7, //$maxFiles
                        Monolog\Logger::DEBUG,
                    ],
                    'formatter' => [
                        'class' => Monolog\Formatter\LineFormatter::class,
                        'constructor' => [null, 'Y-m-d H:i:s', true],
                    ],
                ]
            ],
        ],
    ],
    Logger::getLogChannelConfigs(), // merge 这个
);

新增一个日志 channel，执行以下两步操作：
1. （必须）在 config/plugin/webman-tech/logger/log-channel.php 的 channels 中添加日志 channel 的名字，建议小驼峰命名，例如 purchaseOrder
2. （建议）在 support\facade\Logger 的类上方添加注释：@method static void purchaseOrder($msg, string $type = 'info', array $context = [])

步骤2是为了代码提示，后期记录日志可以直接使用 support\facade\Logger::purchaseOrder('xxx') 的形式，
如果未定义该类，一样可以使用 support\Log::channel('purchaseOrder')->info('xxx') 的方式去记录日志

后期新增其他 channel，只需要重复4即可

使用

假设已经在 config/plugin/webman-tech/logger/log-channel.php 的 channels 中配置了两个 channels: app 和 sql，建议有如下 Logger 类：

<?php

namespace support\facade;

/**
 * @method static void app($msg, string $type = 'info', array $context = [])
 * @method static void sql($msg, string $type = 'info', array $context = [])
 */
class Logger extends \WebmanTech\Logger\Logger
{
}

记录日志

use support\facade\Logger;

Logger::app('xxx'); // 记录 xxx 到 app channel
Logger::app(['x' => 'y']); // 支持数组写入，写入日志时会转成 json
Logger::app($exception); // 支持 Exception 写入，写入时会记录详细的 trace
Logger::app('xxx', 'error'); // 切换 level
Logger::app('hello: {name}', 'info', ['name' => 'Kriss']); // 使用 PsrLogMessageProcessor 处理，会记录成 "hello Kriss"