CoreFiles by mySites.guru
LoggerRegistry.php98 lines, 2,362 bytes, from Joomla_4.0.0-beta5-Beta-Full_Package.zip
Raw History Compare with 4.0.0-beta4
md5
bc858f07f5ab5a40ce9a472d7012db93
sha1
db1b87b5eb88ed8b4ea906b238291be1341340e9
sha256
9f82f1c05a322bb9e61e29e023b2d7ae0d61ed847b61c70a75573abc5315f281
<?php
/**
 * Joomla! Content Management System
 *
 * @copyright  Copyright (C) 2005 - 2020 Open Source Matters, Inc. All rights reserved.
 * @license    GNU General Public License version 2 or later; see LICENSE.txt
 */

namespace Joomla\CMS\Log;

\defined('JPATH_PLATFORM') or die;

/**
 * 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;
	}
}

No other release has this exact content. See every version of this file.