70 lines
1.9 KiB
PHP
70 lines
1.9 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;
|
|
|
|
/**
|
|
* Base Handler class providing the Handler structure, including processors and formatters
|
|
*
|
|
* Classes extending it should (in most cases) only implement write($record)
|
|
*
|
|
* @author Jordi Boggiano <j.boggiano@seld.be>
|
|
* @author Christophe Coevoet <stof@notk.org>
|
|
*
|
|
* @phpstan-import-type LevelName from \Monolog\Logger
|
|
* @phpstan-import-type Level from \Monolog\Logger
|
|
* @phpstan-import-type Record from \Monolog\Logger
|
|
* @phpstan-type FormattedRecord array{message: string, context: mixed[], level: Level, level_name: LevelName, channel: string, datetime: \DateTimeImmutable, extra: mixed[], formatted: mixed}
|
|
*/
|
|
abstract class AbstractProcessingHandler extends AbstractHandler implements ProcessableHandlerInterface, FormattableHandlerInterface
|
|
{
|
|
use ProcessableHandlerTrait;
|
|
use FormattableHandlerTrait;
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
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;
|
|
}
|
|
|
|
/**
|
|
* Writes the record down to the log of the implementing handler
|
|
*
|
|
* @phpstan-param FormattedRecord $record
|
|
*/
|
|
abstract protected function write(array $record): void;
|
|
|
|
/**
|
|
* @return void
|
|
*/
|
|
public function reset()
|
|
{
|
|
parent::reset();
|
|
|
|
$this->resetProcessors();
|
|
}
|
|
}
|