Monolog 修改

已于 2023-07-19 15:40:03 修改
阅读量661 收藏
点赞数
文章标签： php
于 2023-07-19 15:39:32 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/lsswear/article/details/131803304
版权

monolog是记录日志的php框架，应用广泛。

github地址：https://github.com/Seldaek/monolog

composer地址：monolog/monolog - Packagist

之前一直用tp，tp保存日志时若是数组或对象，会保留格式输出，大概是每个数据一行，容易看。用原生的monolog的话，会被变成json放到文件中，没有格式，看起来困难。又因为它输入到文件的内容是通过字符串替换实现，所以即使设置var_export()也会变成一行，不是很符合要求。

使用

#Monolog\Logger
public function __construct(string $name, array $handlers = [], array $processors = [], ?DateTimeZone $timezone = null) {
		$this->name = $name;
		$this->setHandlers($handlers);
		$this->processors = $processors;
		$this->timezone = $timezone ?: new DateTimeZone(date_default_timezone_get() ?: 'UTC');

		if (\PHP_VERSION_ID >= 80100) {
			// Local variable for phpstan, see https://github.com/phpstan/phpstan/issues/6732#issuecomment-1111118412
			/** @var \WeakMap<\Fiber, int> $fiberLogDepth */
			$fiberLogDepth = new \WeakMap();
			$this->fiberLogDepth = $fiberLogDepth;
		}
	}
public function pushHandler(HandlerInterface $handler): self{
		array_unshift($this->handlers, $handler);

		return $this;
	}
public function pushProcessor(callable $callback): self{
		array_unshift($this->processors, $callback);

		return $this;
	}
public function addRecord(int $level, string $message, array $context = [], DateTimeImmutable $datetime = null): bool {
    ……
    foreach ($this->handlers as $handler) {
        if (null === $record) {
			#判断level是否可被记录
            if (!$handler->isHandling(['level' => $level])) {
				continue;
			}
        }
    }
    ……
    #记录日志
    if (true === $handler->handle($record)) {
		break;
	}
    ……
}

所以根据Logger类，可以在构造设置handler或者单独设置，并且没有handler不能记录日志。

$log = new Logger('test1');
$logfile = "logs/20230718.log";
$sream = new StreamHandler($logfile, Logger::DEBUG);
$log->pushHandler($sream);
$log->warning('test1', ['qwe' => '123']);

#记录结果
[2023-07-19T10:53:21.235082+08:00] test1.WARNING: test1 {"qwe":"123"} []

这是经过格式化后的效果。

Monolog\Handler\StreamHandler继承Monolog\Handler\AbstractProcessingHandler，AbstractProcessingHandler继承Monolog\Handler\AbstractHandler。

#Monolog\Handler\AbstractProcessingHandler 
public function handle(array $record): bool
    {
        if (!$this->isHandling($record)) {
            return false;
        }

        if ($this->processors) {
            /** @var Record $record */
            $record = $this->processRecord($record);
        }

        $record['formatted'] = $this->getFormatter()->format($record);

        $this->write($record);

        return false === $this->bubble;
    }

#Monolog\Handler\AbstractHandler
public function isHandling(array $record): bool
    {
        return $record['level'] >= $this->level;
    }

#Monolog\Handler\StreamHandler
protected function write(array $record): void {
		if (!is_resource($this->stream)) {
			$url = $this->url;
			if (null === $url || '' === $url) {
				throw new \LogicException('Missing stream url, the stream can not be opened. This may be caused by a premature call to close().' . Utils::getRecordMessageForException($record));
			}
			$this->createDir($url);
			$this->errorMessage = null;
			set_error_handler([$this, 'customErrorHandler']);
			$stream = fopen($url, 'a');
			if ($this->filePermission !== null) {
				@chmod($url, $this->filePermission);
			}
			restore_error_handler();
			if (!is_resource($stream)) {
				$this->stream = null;

				throw new \UnexpectedValueException(sprintf('The stream or file "%s" could not be opened in append mode: ' . $this->errorMessage, $url) . Utils::getRecordMessageForException($record));
			}
			stream_set_chunk_size($stream, $this->streamChunkSize);
			$this->stream = $stream;
		}

		$stream = $this->stream;
		if (!is_resource($stream)) {
			throw new \LogicException('No stream was opened yet' . Utils::getRecordMessageForException($record));
		}

		if ($this->useLocking) {
			// ignoring errors here, there's not much we can do about them
			flock($stream, LOCK_EX);
		}

		$this->streamWrite($stream, $record);

		if ($this->useLocking) {
			flock($stream, LOCK_UN);
		}
	}
protected function streamWrite($stream, array $record): void{
		fwrite($stream, (string) $record['formatted']);
	}

#Monolog\Logger
	public const DEBUG = 100;
    public const INFO = 200;
    public const NOTICE = 250;
    public const WARNING = 300;
    public const ERROR = 400;
    public const CRITICAL = 500;
    public const ALERT = 550;
    public const EMERGENCY = 600;

由代码可见，AbstractProcessingHandler::handle()处理格式化并调用父类测level判断，和子类的实际写入，也就是例子中的StreamHandler::write()->streamWrite()。

level判断根据level值的大小判断。所以设置debug都会记录，而设置emergency都不会被记录。

所以改下StreamHandler::streamWrite()应该能改变保存的格式，但是最后输出的内容仍然涉及格式化。

#Monolog\Handler\AbstractProcessingHandler
abstract class AbstractProcessingHandler extends AbstractHandler implements ProcessableHandlerInterface, FormattableHandlerInterface
{
    use ProcessableHandlerTrait;
    use FormattableHandlerTrait;
}

#Monolog\Handler\FormattableHandlerTrait
trait FormattableHandlerTrait
{
    /**
     * @var ?FormatterInterface
     */
    protected $formatter;

    /**
     * {@inheritDoc}
     */
    public function setFormatter(FormatterInterface $formatter): HandlerInterface
    {
        $this->formatter = $formatter;

        return $this;
    }

    /**
     * {@inheritDoc}
     */
    public function getFormatter(): FormatterInterface
    {
        if (!$this->formatter) {
            $this->formatter = $this->getDefaultFormatter();
        }

        return $this->formatter;
    }

    /**
     * Gets the default formatter.
     *
     * Overwrite this if the LineFormatter is not a good default for your handler.
     */
    protected function getDefaultFormatter(): FormatterInterface
    {
        return new LineFormatter();
    }
}

#Monolog\Handler\ProcessableHandlerTrait
trait ProcessableHandlerTrait
{
    /**
     * @var callable[]
     * @phpstan-var array<ProcessorInterface|callable(Record): Record>
     */
    protected $processors = [];

    /**
     * {@inheritDoc}
     */
    public function pushProcessor(callable $callback): HandlerInterface
    {
        array_unshift($this->processors, $callback);

        return $this;
    }

    /**
     * {@inheritDoc}
     */
    public function popProcessor(): callable
    {
        if (!$this->processors) {
            throw new \LogicException('You tried to pop from an empty processor stack.');
        }

        return array_shift($this->processors);
    }

    /**
     * Processes a record.
     *
     * @phpstan-param  Record $record
     * @phpstan-return Record
     */
    protected function processRecord(array $record): array
    {
        foreach ($this->processors as $processor) {
            $record = $processor($record);
        }

        return $record;
    }

    protected function resetProcessors(): void
    {
        foreach ($this->processors as $processor) {
            if ($processor instanceof ResettableInterface) {
                $processor->reset();
            }
        }
    }

AbstractProcessingHandler使用ProcessableHandlerTrait和FormattableHandlerTrait。因为handler和process都是数组，这两者都是对数组的操作，handler会设置默认Monolog\Formatter\LineFormatter类。

#Monolog\Formatter\LineFormatter
class LineFormatter extends NormalizerFormatter
{
     public const SIMPLE_FORMAT = "[%datetime%] %channel%.%level_name%: %message% %context% %extra%\n";
    ……
      public function __construct(?string $format = null, ?string $dateFormat = null, bool $allowInlineLineBreaks = false, bool $ignoreEmptyContextAndExtra = false, bool $includeStacktraces = false)
    {
        $this->format = $format === null ? static::SIMPLE_FORMAT : $format;
        ……
        parent::__construct($dateFormat);
    }
     public function format(array $record): string
    {
        $vars = parent::format($record);

        $output = $this->format;

        foreach ($vars['extra'] as $var => $val) {
            if (false !== strpos($output, '%extra.'.$var.'%')) {
                $output = str_replace('%extra.'.$var.'%', $this->stringify($val), $output);
                unset($vars['extra'][$var]);
            }
        }

        foreach ($vars['context'] as $var => $val) {
            if (false !== strpos($output, '%context.'.$var.'%')) {
                $output = str_replace('%context.'.$var.'%', $this->stringify($val), $output);
                unset($vars['context'][$var]);
            }
        }

        if ($this->ignoreEmptyContextAndExtra) {
            if (empty($vars['context'])) {
                unset($vars['context']);
                $output = str_replace('%context%', '', $output);
            }

            if (empty($vars['extra'])) {
                unset($vars['extra']);
                $output = str_replace('%extra%', '', $output);
            }
        }

        foreach ($vars as $var => $val) {
            if (false !== strpos($output, '%'.$var.'%')) {
                $output = str_replace('%'.$var.'%', $this->stringify($val), $output);
            }
        }

        // remove leftover %extra.xxx% and %context.xxx% if any
        if (false !== strpos($output, '%')) {
            $output = preg_replace('/%(?:extra|context)\..+?%/', '', $output);
            if (null === $output) {
                $pcreErrorCode = preg_last_error();
                throw new \RuntimeException('Failed to run preg_replace: ' . $pcreErrorCode . ' / ' . Utils::pcreLastErrorMessage($pcreErrorCode));
            }
        }

        return $output;
    }
}

#Monolog\Formatter\NormalizerFormatter
class NormalizerFormatter implements FormatterInterface
{
    public const SIMPLE_DATE = "Y-m-d\TH:i:sP";
    ……
      public function __construct(?string $dateFormat = null)
    {
        $this->dateFormat = null === $dateFormat ? static::SIMPLE_DATE : $dateFormat;
        if (!function_exists('json_encode')) {
            throw new \RuntimeException('PHP\'s json extension is required to use Monolog\'s NormalizerFormatter');
        }
    }
    public function format(array $record)
    {
        return $this->normalize($record);
    }
     protected function normalize($data, int $depth = 0)
    {
        if ($depth > $this->maxNormalizeDepth) {
            return 'Over ' . $this->maxNormalizeDepth . ' levels deep, aborting normalization';
        }

        if (null === $data || is_scalar($data)) {
            if (is_float($data)) {
                if (is_infinite($data)) {
                    return ($data > 0 ? '' : '-') . 'INF';
                }
                if (is_nan($data)) {
                    return 'NaN';
                }
            }

            return $data;
        }

        if (is_array($data)) {
            $normalized = [];

            $count = 1;
            foreach ($data as $key => $value) {
                if ($count++ > $this->maxNormalizeItemCount) {
                    $normalized['...'] = 'Over ' . $this->maxNormalizeItemCount . ' items ('.count($data).' total), aborting normalization';
                    break;
                }

                $normalized[$key] = $this->normalize($value, $depth + 1);
            }

            return $normalized;    
        }
        ……
    }
    
}

LineFormatter设置默认格式，先调用父类格式化，之后再根据格式替换字符。时间格式是通过父类格式化。

父类NormalizerFormatter，设置默认时间格式。通过normalize函数递归调用格式化数据。大于最大层数maxNormalizeItemCount=1000,可能会显示异常。

最终修改

$autoloadfile = "vendor/autoload.php";
require_once $autoloadfile;

use Monolog\Handler\StreamHandler;
use Monolog\Logger;
use Monolog\Formatter\LineFormatter;

class myStreamHandler extends StreamHandler {
	protected function streamWrite($stream, array $record): void{
		$str = (string) $record['formatted'] . PHP_EOL . var_export($record['context'], true). PHP_EOL;
		fwrite($stream, $str);
	}
}

$logfile = "logs/20230718.log";
$log = new Logger('test1');

$dateFormat = "Y-m-d H:i:s";
$output = "%datetime%||%channel%||%level_name%\n%message%\n%extra%";
$formatter = new LineFormatter($output, $dateFormat);

//$sream = new StreamHandler($logfile, Logger::DEBUG);
$sream = new myStreamHandler($logfile, Logger::DEBUG);
$sream->setFormatter($formatter);

$log->pushHandler($sream);
$log->pushProcessor(function ($record) {
    var_dump($record);
    $record['extra']['test'] ='test' ;    
    return $record;
});


#执行输出
array(7) {
  'message' =>
  string(5) "test1"
  'context' =>
  array(1) {
    'qwe' =>
    string(3) "123"
  }
  'level' =>
  int(300)
  'level_name' =>
  string(7) "WARNING"
  'channel' =>
  string(5) "test1"
  'datetime' =>
  class Monolog\DateTimeImmutable#7 (4) {
    private $useMicroseconds =>
    bool(true)
    public $date =>
    string(26) "2023-07-19 15:15:31.218972"
    public $timezone_type =>
    int(3)
    public $timezone =>
    string(13) "Asia/Shanghai"
  }
  'extra' =>
  array(1) {
    'test' =>
    string(4) "test"
  }
}

#日志写入
2023-07-19 15:18:09||test1||WARNING
test1
{"test":"test"}
array (
  'qwe' => '123',
)

总结

monolog设计采用多层继承，将统一使用的方法抽象出类，其子类负责呈上启下的流程调用，其子类的子类则通过方法重写负责具体实现。

数据格式化可以使用HtmlFormatter或者JsonFormatter可以自己定义。

handler可以使用RedisHandler、PHPConsoleHandler等，根据构造不同穿的参数不同，功能很多，还能发送email。

比如process可以在write调用之前处理缓存数据，例如 MemoryPeakUsageProcessor设置内存用量 ，可以对extra参数设置逻辑数据。

lsswear
关注
PHP 错误级别
行人事，知天命
09-29 1881
在PHP开发的时候常常会用到error_reporting(report_level)来调试自己的程序，下面列出了report_level可能值： 值 常量 描述 1 E_ERROR 这是一个严重错误，不可恢复，如位置异常，内存不足等 2 E_WARNING 警告，最一般的错误，如函数的参数错误等 4 E_PARSE 解析错误
error_reporting() 错误级别详解
weixin_34290000的博客
10-13 277
在PHP开发的时候常常会用到error_reporting(report_level)来调试自己的程序。下面列出了report_level可能值 值常量描述 1 E_ERROR 这是一个严重错误，不可恢复，如位置异常，内存不足等 2 E_WARNING 警告，最一般的错误，如函数的参数错误等 4 E_PARSE 解析错误，在解析PHP文件时产生，并强...
归一化php,归一化函数normalize详解
weixin_42350014的博客
03-17 360
opencv 2 归一化函数normalize详解1. 归一化定义与作用归一化就是要把需要处理的数据经过处理后(通过某种算法)限制在你需要的一定范围内。首先归一化是为了后面数据处理的方便，其次是保证程序运行时收敛加快。归一化的具体作用是归纳统一样本的统计分布性。归一化在0-1之间是统计的概率分布，归一化在某个区间上是统计的坐标分布。归一化有同一、统一和合一的意思。归一化的目的简而言之，是使得没有可...
php json_encode错误处理
qq_16618179的博客
10-16 1062
数组里面有其他语种导致json_encode报错的处理 其实官方文档有给解决方案，但是没有解决好，下面是我实测没问题的代码！ /** * 描述 : json_encode格式化 * 参数 ：$value 需要encode的数据 * 作者 : Smart.Chen */ public function safe_json_encode($value, $options = 0, $depth = 512, $utfErrorFlag = false) {
exception() php,PHP Exception
weixin_40004051的博客
03-19 96
LogicExceptionException that represents error in the program logic. This kind of exception should lead directly to a fix in your code.代码里必须解决的异常节选开源代码/*** Static shortcut to \Mockery\Container::self()...
php多进程 写入文件_PHP多进程中使用file_put_contents安全吗？
weixin_36098968的博客
03-09 654
TL;DRLinux下，PHP多进程使用 file_put_contents() 方法记录日志时，使用追加模式(FILE_APPEND)，简短的日志内容不会重叠，即能安全的记录日志内容。file_put_contents() 使用 write() 系统调用实现数据的写入，write() 系统调用对普通文件保证写入数据的完整性，O_APPEND 打开模式保证数据写入到文件末尾。如果愿意的话，也可以考...
think-monolog:ThinkPHP3.2集成monolog
05-09
也就是说, 在不修改TP源码的情况下想用monolog收集trace数据, TRACE BAR 和 monolog 你只能二选一. 而本人扩展框架的原则是, 为了不影响升级框架, 对框架的功能扩展绝不修改源码. 因此, 集成mono
Laravel开发-monolog-mysql
08-28
此外，你可以进一步定制`monolog-mysql`的行为，例如添加自定义处理器或修改日志字段。Monolog允许你定义处理器链，这样在日志信息写入数据库之前，可以进行额外的数据处理或过滤。例如，可以添加一个处理器来获取...
Laravel开发-laravel-monolog-config
08-28
- 例如，如果你想改变默认的日志存储位置，可以在`channels`中更改`single`或`daily`通道的`path`选项。 2. **处理器和处理器配置** - Monolog支持添加处理器，处理器是负责处理日志消息的对象。Laravel预设了...
Laravel开发-laravel-monolog-processors
08-27
Monolog的处理器可以通过`process`方法在日志消息发送到存储之前对其进行修改。例如，`AddProcessIdProcessor`可以添加当前进程ID到日志条目中，帮助追踪并发问题。`AddContextProcessor`则可以将请求上下文信息（如...
Elasticsearch --- （十一）初识搜索引擎《一》
weixin_43240792的博客
05-21 840
1、search结果深入解析（search timeout机制） （1）搜索结果里的各种数据的含义 GET /_search { "took": 6, "timed_out": false, "_shards": { "total": 6, "successful": 6, "failed": 0 }, "hits": { "total": 10, "max_score": 1, "hits": [ {
深度学习（二十九）——Normalization进阶, CTC
antkillerfarm的专栏
11-05 1373
Normalization进阶 和Batch Normalization类似的概念还有Weight Normalization和Layer Normalization。 Batch Normalization 从上图可以看出，BN是对input tensor的每个通道进行mini-batch级别的Normalization。而LN则是对所有通道的input tensor进行Normalizati...
深度学习论文
gdtop的个人笔记
02-24 1万+
一、ImageNet Evolution 以下五篇论文是深度学习的破冰著作，见证了卷积神经网络越来越深，效果越来越好，其中ResNet更是在原始网络结构上有了新的突破~~ [Nature15] Deep Learning：摘自Yann LeCun和Youshua Bengio以及GeoffreyHinton三人合著发表在nature2015的论文 [NeurIPS12] ImageNet ...
laravel框架使用中错误及解决办法总结 2
json_li的博客
02-21 4122
Laravel 出现"RuntimeException inEncrypter.php line 43: The only supported ciphers are AES-128-CBC and AES-256-CBC with the correct key lengths."问题的解决办法 Laravel访问出错异常信息：Warning: require(/vendor/autoload.php): failed to open stream: No such file or dire
PHP 中的一些 “陷阱”
weixin_34242819的博客
02-02 115
在做开发的时候，有可能会忘记掉一些技术细节。这些细节有可能会造成很严重的后果，比如网站被注入、网站崩溃等等。现在我们总结一下，有可能会遇到的一些 PHP 中的一些 “陷阱”。 陷阱一：empty() <?php //以下代码会直接导致PHP解析错误 $arr1 = [1, 2, 3]; $arr2 = [3, 4]; if(e...
安装简单SMTP_sendmail发送邮件
热门推荐
心　境地
06-29 4万+
安装简单sendmail发送邮件 1,安装 yum install -y sendmail* rpm -aq | grep sendmail sendmail-doc-8.13.8-2.el5 sendmail-cf-8.13.8-2.el5 sendmail-devel-8.13.8-2.el5 sendmail-8.13.8-2.el5 2,更改配置 cd /etc/mail vi
Laravel开发采坑系列问题
weixin_34192993的博客
12-22 389
2017年12月22日17:40:03 不定时更新 版本5.4.X 一下是可能会遇到的坑 1，必须的写路由转发才能访问控制器，当然你可以自动路由访问，但是需要些匹配规则，其实还是转发了 好多人讨论过自动路由的缺点，但是中小项目用不上，而且暴露在外的接口，现在大多数都是有路由转发，完全可以通过分组来兼容多种开发习惯和需求，并不是自动路由就狗屁不是 2，Laravel 做计划任务的时候坑真的...
自定义Laravel Monolog日志位置与请求ID集成
1. 修改 `bootstrap/app.php` 的 Monolog 配置，设置日志处理器和文件路径。 2. 扩展 `LogServiceProvider`，重写 `configureSingleHandler()` 方法，处理请求 ID 的生成和日志记录。 3. 可能需要在适当的地方插入...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

lsswear

感谢大佬打赏 q(≧▽≦q)

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值