apolinux/logger

简单的日志记录器

v0.6 2024-07-31 16:03 UTC

This package is auto-updated.

Last update: 2024-10-01 00:17:37 UTC


README

将文本注册到文件。

安装

composer require Apolinux/logger 

描述

首先步骤,必须使用init静态方法配置日志参数

Logger::init($logname);

然后,每当需要时调用log方法。

Logger::log('something to log');

...

Logger::log(['phone' => 123 ,'date' => time() ]);

初始化方法

Logger::init($filename, 
    string $context_format    = self::DEFAULT_CONTEXT_FORMAT,  
    string $date_format       = 'c', 
    ?string $file_date_format = 'Ymd')

$filename: 指定日志目标文件名

$context_format: 描述文本格式。默认为

{date}|{sid}|{tag}|{context}

其中

  • date: 是由 $date_format 指定格式的日期。如果需要,可以添加微秒或毫秒。
  • sid: 是每次调用init()时生成的随机字符串。
  • tag: 是用于后续搜索日志的标签。
  • context: 是要写入日志的信息

所有参数都是可选的,您可以根据需要更改格式。

$date_format: 可选。PHP date()函数支持的格式。描述 context_format 中的 {date} 格式。默认为 'c'。

$file_date_format: 可选。PHP date()函数支持的格式。定义文件名中的日期格式,默认为 'Ymd'。

日志方法

Logger::log($data_log, $tag = self::DEFAULT_TAG);

$data_log: 要写入文件的文本、数组或对象。

$tag: 可选。标识日志的标签。默认为 'default'。

示例

require_once 'vendor/autoload.php' ;

use Apolinux\Logger ;

Logger::init(
  'dirlogs/filetosavelogs.log' ,
  '{date}|{sid}|{tag}|{context}' ,
  'YmdHis.u',
  'Ymd'
) ;

...

Logger::log('information to be logged','info') ;

...

Logger::log(['type' => 'human', 'name' => 'Diana'],'register');

待办事项

  • 使用json格式化完整行
  • 编码文件以减少日志大小
  • 创建日志阅读器
  • 在日志中搜索