logger.php

См. документацию.

<?php

 
namespace Bitrix\Main\Diag;
 
use Psr\Log;
use Psr\Log\LogLevel;
use Bitrix\Main\Config;
use Bitrix\Main\DI;
 
abstract class Logger extends Log\AbstractLogger
{
    protected static $supportedLevels = [
        LogLevel::EMERGENCY => LOG_EMERG,
        LogLevel::ALERT => LOG_ALERT,
        LogLevel::CRITICAL => LOG_CRIT,
        LogLevel::ERROR => LOG_ERR,
        LogLevel::WARNING => LOG_WARNING,
        LogLevel::NOTICE => LOG_NOTICE,
        LogLevel::INFO => LOG_INFO,
        LogLevel::DEBUG => LOG_DEBUG,
    ];
 
    protected $level;

    protected $formatter;
 
    protected array $context;
    protected string $message;
 
    protected function interpolate()
    {
        $formatter = $this->getFormatter();
 
        return $formatter->format($this->message, $this->context);
    }

    public function log($level, string|\Stringable $message, array $context = []): void
    {
        // Calling this method with a level not defined by this specification MUST throw a Psr\Log\InvalidArgumentException if the implementation does not know about the level.
        if (!isset(static::$supportedLevels[$level]))
        {
            throw new Log\InvalidArgumentException("Log level {$level} is unsupported.");
        }
 
        if ($this->level !== null && static::$supportedLevels[$level] > $this->level)
        {
            // shouldn't log anything because of the maximum verbose level
            return;
        }
 
        $this->context = $context;
        $this->message = $message;
 
        // The message MAY contain placeholders which implementors MAY replace with values from the context array.
        $message = $this->interpolate();
 
        if ($message != '')
        {
            // actual logging - MUST be defined by a child class
            $this->logMessage($level, $message);
        }
    }
 
    abstract protected function logMessage(string $level, string $message);

    public function setLevel(string $level)
    {
        if (isset(static::$supportedLevels[$level]))
        {
            $this->level = static::$supportedLevels[$level];
        }
 
        return $this;
    }

    public function setFormatter(LogFormatterInterface $formatter)
    {
        $this->formatter = $formatter;
 
        return $this;
    }

    public static function create(string $id, $params = [])
    {
        $loggersConfig = Config\Configuration::getValue('loggers');
 
        $logger = null;
 
        if (isset($loggersConfig[$id]))
        {
            $config = $loggersConfig[$id];
 
            if (isset($config['className']))
            {
                $class = $config['className'];
 
                $args = $config['constructorParams'] ?? [];
                if ($args instanceof \Closure)
                {
                    $args = $args();
                }
 
                $logger = new $class(...array_values($args));
            }
            elseif (isset($config['constructor']))
            {
                $closure = $config['constructor'];
                if ($closure instanceof \Closure)
                {
                    $logger = $closure(...array_values($params));
                }
            }
 
            if ($logger instanceof static)
            {
                if (isset($config['level']))
                {
                    $logger->setLevel($config['level']);
                }
 
                if (isset($config['formatter']))
                {
                    $serviceLocator = DI\ServiceLocator::getInstance();
                    if ($serviceLocator->has($config['formatter']))
                    {
                        $logger->setFormatter($serviceLocator->get($config['formatter']));
                    }
                }
            }
        }
 
        return $logger;
    }
 
    protected function getFormatter()
    {
        if ($this->formatter === null)
        {
            $this->formatter = new LogFormatter();
        }
 
        return $this->formatter;
    }
}