LogManager.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Core\Log;

class LogManager implements \TYPO3\CMS\Core\SingletonInterface {

    const CONFIGURATION_TYPE_WRITER = 'writer';
    const CONFIGURATION_TYPE_PROCESSOR = 'processor';
    protected $loggers = array();

    protected $rootLogger = NULL;

    public function __construct() {
        $this->rootLogger = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Core\\Log\\Logger', '');
        $this->loggers[''] = $this->rootLogger;
    }

    public function reset() {
        $this->loggers = array();
    }

    public function getLogger($name = '') {
        $logger = NULL;
        // Transform namespaces and underscore class names to the dot-name style
        $separators = array('_', '\\');
        $name = str_replace($separators, '.', $name);
        if (isset($this->loggers[$name])) {
            $logger = $this->loggers[$name];
        } else {
            // Lazy instantiation
            $logger = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Core\\Log\\Logger', $name);
            $this->loggers[$name] = $logger;
            $this->setWritersForLogger($logger);
            $this->setProcessorsForLogger($logger);
        }
        return $logger;
    }

    public function registerLogger($name) {
        $this->loggers[$name] = NULL;
    }

    public function getLoggerNames() {
        return array_keys($this->loggers);
    }

    protected function setWritersForLogger(\TYPO3\CMS\Core\Log\Logger $logger) {
        $configuration = $this->getConfigurationForLogger(self::CONFIGURATION_TYPE_WRITER, $logger->getName());
        foreach ($configuration as $severityLevel => $writer) {
            foreach ($writer as $logWriterClassName => $logWriterOptions) {
                $logWriter = NULL;
                try {
                    $logWriter = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance($logWriterClassName, $logWriterOptions);
                    $logger->addWriter($severityLevel, $logWriter);
                } catch (\RangeException $e) {
                    $logger->warning('Instantiation of LogWriter "' . $logWriterClassName . '" failed for logger ' . $logger->getName() . ' (' . $e->getMessage() . ')');
                }
            }
        }
    }

    protected function setProcessorsForLogger(\TYPO3\CMS\Core\Log\Logger $logger) {
        $configuration = $this->getConfigurationForLogger(self::CONFIGURATION_TYPE_PROCESSOR, $logger->getName());
        foreach ($configuration as $severityLevel => $processor) {
            foreach ($processor as $logProcessorClassName => $logProcessorOptions) {
                $logProcessor = NULL;
                try {
                    $logProcessor = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance($logProcessorClassName, $logProcessorOptions);
                    $logger->addProcessor($severityLevel, $logProcessor);
                } catch (\RangeException $e) {
                    $logger->warning('Instantiation of LogProcessor "' . $logProcessorClassName . '" failed for logger ' . $logger->getName() . ' (' . $e->getMessage() . ')');
                }
            }
        }
    }

    protected function getConfigurationForLogger($configurationType, $loggerName) {
        // Split up the logger name (dot-separated) into its parts
        $explodedName = explode('.', $loggerName);
        // Search in the $TYPO3_CONF_VARS['LOG'] array
        // for these keys, for example "writerConfiguration"
        $configurationKey = $configurationType . 'Configuration';
        $configuration = $GLOBALS['TYPO3_CONF_VARS']['LOG'];
        $result = $configuration[$configurationKey] ?: array();
        // Walk from general to special (t3lib, t3lib.db, t3lib.db.foo)
        // and search for the most specific configuration
        foreach ($explodedName as $partOfClassName) {
            if (!empty($configuration[$partOfClassName][$configurationKey])) {
                $result = $configuration[$partOfClassName][$configurationKey];
            }
            $configuration = $configuration[$partOfClassName];
        }
        // Validate the config
        foreach ($result as $level => $unused) {
            try {
                \TYPO3\CMS\Core\Log\LogLevel::validateLevel($level);
            } catch (\RangeException $e) {
                throw new \RangeException('The given severity level "' . htmlspecialchars($level) . '" for ' . $configurationKey . ' of logger "' . $loggerName . '" is not valid.', 1326406447);
            }
        }
        return $result;
    }

}