LoggerFactory.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Logger;
 
use LogicException;
use Wikimedia\ObjectFactory\ObjectFactory;
 
class LoggerFactory {
 
    private static $spi;
 
    private static ?LoggingContext $context;
 
    public static function registerProvider( Spi $provider ) {
        self::$spi = $provider;
    }
 
    public static function getProvider() {
        if ( self::$spi === null ) {
            global $wgMWLoggerDefaultSpi;
            $provider = ObjectFactory::getObjectFromSpec(
                $wgMWLoggerDefaultSpi
            );
            self::registerProvider( $provider );
        }
        return self::$spi;
    }
 
    public static function getInstance( $channel ) {
        return self::getProvider()->getLogger( $channel );
    }
 
    public static function getContext(): LoggingContext {
        self::$context ??= new LoggingContext();
        return self::$context;
    }
 
    public static function setContext( LoggingContext $context ): void {
        if ( !defined( 'MW_PHPUNIT_TEST' ) && !defined( 'MW_PARSER_TEST' ) ) {
            throw new LogicException( __METHOD__ . ' can only be used in PHPUnit tests' );
        }
        self::$context = $context;
    }
 
    private function __construct() {
        // no-op
    }
}