forked from friendica/friendica-addons
140 lines
4.2 KiB
PHP
140 lines
4.2 KiB
PHP
<?php declare(strict_types=1);
|
|
|
|
/*
|
|
* This file is part of the Monolog package.
|
|
*
|
|
* (c) Jordi Boggiano <j.boggiano@seld.be>
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
namespace Monolog\Handler;
|
|
|
|
use Monolog\Level;
|
|
use Monolog\Formatter\FormatterInterface;
|
|
use Monolog\LogRecord;
|
|
|
|
/**
|
|
* Handler to only pass log messages when a certain threshold of number of messages is reached.
|
|
*
|
|
* This can be useful in cases of processing a batch of data, but you're for example only interested
|
|
* in case it fails catastrophically instead of a warning for 1 or 2 events. Worse things can happen, right?
|
|
*
|
|
* Usage example:
|
|
*
|
|
* ```
|
|
* $log = new Logger('application');
|
|
* $handler = new SomeHandler(...)
|
|
*
|
|
* // Pass all warnings to the handler when more than 10 & all error messages when more then 5
|
|
* $overflow = new OverflowHandler($handler, [Level::Warning->value => 10, Level::Error->value => 5]);
|
|
*
|
|
* $log->pushHandler($overflow);
|
|
*```
|
|
*
|
|
* @author Kris Buist <krisbuist@gmail.com>
|
|
*/
|
|
class OverflowHandler extends AbstractHandler implements FormattableHandlerInterface
|
|
{
|
|
private HandlerInterface $handler;
|
|
|
|
/** @var array<int, int> */
|
|
private array $thresholdMap = [];
|
|
|
|
/**
|
|
* Buffer of all messages passed to the handler before the threshold was reached
|
|
*
|
|
* @var mixed[][]
|
|
*/
|
|
private array $buffer = [];
|
|
|
|
/**
|
|
* @param array<int, int> $thresholdMap Dictionary of log level value => threshold
|
|
*/
|
|
public function __construct(
|
|
HandlerInterface $handler,
|
|
array $thresholdMap = [],
|
|
$level = Level::Debug,
|
|
bool $bubble = true
|
|
) {
|
|
$this->handler = $handler;
|
|
foreach ($thresholdMap as $thresholdLevel => $threshold) {
|
|
$this->thresholdMap[$thresholdLevel] = $threshold;
|
|
}
|
|
parent::__construct($level, $bubble);
|
|
}
|
|
|
|
/**
|
|
* Handles a record.
|
|
*
|
|
* All records may be passed to this method, and the handler should discard
|
|
* those that it does not want to handle.
|
|
*
|
|
* The return value of this function controls the bubbling process of the handler stack.
|
|
* Unless the bubbling is interrupted (by returning true), the Logger class will keep on
|
|
* calling further handlers in the stack with a given log record.
|
|
*
|
|
* @inheritDoc
|
|
*/
|
|
public function handle(LogRecord $record): bool
|
|
{
|
|
if ($record->level->isLowerThan($this->level)) {
|
|
return false;
|
|
}
|
|
|
|
$level = $record->level->value;
|
|
|
|
if (!isset($this->thresholdMap[$level])) {
|
|
$this->thresholdMap[$level] = 0;
|
|
}
|
|
|
|
if ($this->thresholdMap[$level] > 0) {
|
|
// The overflow threshold is not yet reached, so we're buffering the record and lowering the threshold by 1
|
|
$this->thresholdMap[$level]--;
|
|
$this->buffer[$level][] = $record;
|
|
|
|
return false === $this->bubble;
|
|
}
|
|
|
|
if ($this->thresholdMap[$level] == 0) {
|
|
// This current message is breaking the threshold. Flush the buffer and continue handling the current record
|
|
foreach ($this->buffer[$level] ?? [] as $buffered) {
|
|
$this->handler->handle($buffered);
|
|
}
|
|
$this->thresholdMap[$level]--;
|
|
unset($this->buffer[$level]);
|
|
}
|
|
|
|
$this->handler->handle($record);
|
|
|
|
return false === $this->bubble;
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
public function setFormatter(FormatterInterface $formatter): HandlerInterface
|
|
{
|
|
if ($this->handler instanceof FormattableHandlerInterface) {
|
|
$this->handler->setFormatter($formatter);
|
|
|
|
return $this;
|
|
}
|
|
|
|
throw new \UnexpectedValueException('The nested handler of type '.get_class($this->handler).' does not support formatters.');
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
public function getFormatter(): FormatterInterface
|
|
{
|
|
if ($this->handler instanceof FormattableHandlerInterface) {
|
|
return $this->handler->getFormatter();
|
|
}
|
|
|
|
throw new \UnexpectedValueException('The nested handler of type '.get_class($this->handler).' does not support formatters.');
|
|
}
|
|
}
|