2022-10-17 21:25:03 +02:00
|
|
|
<?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\Logger;
|
|
|
|
use Monolog\ResettableInterface;
|
|
|
|
use Psr\Log\LogLevel;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Base Handler class providing basic level/bubble support
|
|
|
|
*
|
|
|
|
* @author Jordi Boggiano <j.boggiano@seld.be>
|
2023-07-02 23:57:24 +02:00
|
|
|
*
|
|
|
|
* @phpstan-import-type Level from \Monolog\Logger
|
|
|
|
* @phpstan-import-type LevelName from \Monolog\Logger
|
2022-10-17 21:25:03 +02:00
|
|
|
*/
|
|
|
|
abstract class AbstractHandler extends Handler implements ResettableInterface
|
|
|
|
{
|
2023-07-02 23:57:24 +02:00
|
|
|
/**
|
|
|
|
* @var int
|
|
|
|
* @phpstan-var Level
|
|
|
|
*/
|
|
|
|
protected $level = Logger::DEBUG;
|
|
|
|
/** @var bool */
|
|
|
|
protected $bubble = true;
|
2022-10-17 21:25:03 +02:00
|
|
|
|
|
|
|
/**
|
2023-07-02 23:57:24 +02:00
|
|
|
* @param int|string $level The minimum logging level at which this handler will be triggered
|
|
|
|
* @param bool $bubble Whether the messages that are handled can bubble up the stack or not
|
2022-10-17 21:25:03 +02:00
|
|
|
*
|
2023-07-02 23:57:24 +02:00
|
|
|
* @phpstan-param Level|LevelName|LogLevel::* $level
|
2022-10-17 21:25:03 +02:00
|
|
|
*/
|
2023-07-02 23:57:24 +02:00
|
|
|
public function __construct($level = Logger::DEBUG, bool $bubble = true)
|
2022-10-17 21:25:03 +02:00
|
|
|
{
|
|
|
|
$this->setLevel($level);
|
|
|
|
$this->bubble = $bubble;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2023-07-02 23:57:24 +02:00
|
|
|
* {@inheritDoc}
|
2022-10-17 21:25:03 +02:00
|
|
|
*/
|
2023-07-02 23:57:24 +02:00
|
|
|
public function isHandling(array $record): bool
|
2022-10-17 21:25:03 +02:00
|
|
|
{
|
2023-07-02 23:57:24 +02:00
|
|
|
return $record['level'] >= $this->level;
|
2022-10-17 21:25:03 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets minimum logging level at which this handler will be triggered.
|
|
|
|
*
|
2023-07-02 23:57:24 +02:00
|
|
|
* @param Level|LevelName|LogLevel::* $level Level or level name
|
|
|
|
* @return self
|
2022-10-17 21:25:03 +02:00
|
|
|
*/
|
2023-07-02 23:57:24 +02:00
|
|
|
public function setLevel($level): self
|
2022-10-17 21:25:03 +02:00
|
|
|
{
|
|
|
|
$this->level = Logger::toMonologLevel($level);
|
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets minimum logging level at which this handler will be triggered.
|
2023-07-02 23:57:24 +02:00
|
|
|
*
|
|
|
|
* @return int
|
|
|
|
*
|
|
|
|
* @phpstan-return Level
|
2022-10-17 21:25:03 +02:00
|
|
|
*/
|
2023-07-02 23:57:24 +02:00
|
|
|
public function getLevel(): int
|
2022-10-17 21:25:03 +02:00
|
|
|
{
|
|
|
|
return $this->level;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets the bubbling behavior.
|
|
|
|
*
|
2023-07-02 23:57:24 +02:00
|
|
|
* @param bool $bubble true means that this handler allows bubbling.
|
|
|
|
* false means that bubbling is not permitted.
|
|
|
|
* @return self
|
2022-10-17 21:25:03 +02:00
|
|
|
*/
|
|
|
|
public function setBubble(bool $bubble): self
|
|
|
|
{
|
|
|
|
$this->bubble = $bubble;
|
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets the bubbling behavior.
|
|
|
|
*
|
|
|
|
* @return bool true means that this handler allows bubbling.
|
|
|
|
* false means that bubbling is not permitted.
|
|
|
|
*/
|
|
|
|
public function getBubble(): bool
|
|
|
|
{
|
|
|
|
return $this->bubble;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2023-07-02 23:57:24 +02:00
|
|
|
* {@inheritDoc}
|
2022-10-17 21:25:03 +02:00
|
|
|
*/
|
2023-07-02 23:57:24 +02:00
|
|
|
public function reset()
|
2022-10-17 21:25:03 +02:00
|
|
|
{
|
|
|
|
}
|
|
|
|
}
|