- md5
- 8076e2b2f2ab117c980bb80a04eafaa9
- sha1
- d00bf56d43428c7ea216004f47bbcf59bc28848e
- sha256
- af11a505d85b2bca8bed9efbb7a1121a066f9d37ae2db27b309aba23688b03bc
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798
<?php
/**
* Joomla! Content Management System
*
* @copyright (C) 2017 Open Source Matters, Inc. <https://www.joomla.org>
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
namespace Joomla\CMS\Log;
// phpcs:disable PSR1.Files.SideEffects
\defined('_JEXEC') or die;
// phpcs:enable PSR1.Files.SideEffects
/**
* Service registry for loggers
*
* @since 4.0.0
*/
final class LoggerRegistry
{
/**
* Array holding the registered services
*
* @var string[]
* @since 4.0.0
*/
private $loggerMap = [
'callback' => Logger\CallbackLogger::class,
'database' => Logger\DatabaseLogger::class,
'echo' => Logger\EchoLogger::class,
'formattedtext' => Logger\FormattedtextLogger::class,
'messagequeue' => Logger\MessagequeueLogger::class,
'syslog' => Logger\SyslogLogger::class,
'w3c' => Logger\W3cLogger::class,
'inmemory' => Logger\InMemoryLogger::class,
];
/**
* Get the logger class for a given key
*
* @param string $key The key to look up
*
* @return string
*
* @since 4.0.0
* @throws \InvalidArgumentException
*/
public function getLoggerClass(string $key): string
{
if (!$this->hasLogger($key)) {
throw new \InvalidArgumentException("The '$key' key is not registered.");
}
return $this->loggerMap[$key];
}
/**
* Check if the registry has a logger for the given key
*
* @param string $key The key to look up
*
* @return boolean
*
* @since 4.0.0
*/
public function hasLogger(string $key): bool
{
return isset($this->loggerMap[$key]);
}
/**
* Register a logger
*
* @param string $key The service key to be registered
* @param string $class The class name of the logger
* @param boolean $replace Flag indicating the service key may replace an existing definition
*
* @return void
*
* @since 4.0.0
*/
public function register(string $key, string $class, bool $replace = false)
{
// If the key exists already and we aren't instructed to replace existing services, bail early
if (isset($this->loggerMap[$key]) && !$replace) {
throw new \RuntimeException("The '$key' key is already registered.");
}
// The class must exist
if (!class_exists($class)) {
throw new \RuntimeException("The '$class' class for key '$key' does not exist.");
}
$this->loggerMap[$key] = $class;
}
}
The same content is in 155 releases, Joomla 5.0.0-alpha1 to 6.2.1-rc1. See them all, or every version of this file.