LockManagerGroup.php

Go to the documentation of this file.

<?php
namespace MediaWiki\FileBackend\LockManager;
 
use Exception;
use InvalidArgumentException;
use MediaWiki\Logger\LoggerFactory;
use Wikimedia\LockManager\LockManager;
 
class LockManagerGroup {
    protected $domain;
 
    protected $managers = [];
 
    public function __construct( $domain, array $lockManagerConfigs ) {
        $this->domain = $domain;
 
        foreach ( $lockManagerConfigs as $config ) {
            $config['domain'] = $this->domain;
            if ( !isset( $config['name'] ) ) {
                throw new InvalidArgumentException( "Cannot register a lock manager with no name." );
            }
            $name = $config['name'];
            if ( !isset( $config['class'] ) ) {
                throw new InvalidArgumentException( "Cannot register lock manager `{$name}` with no class." );
            }
            $class = $config['class'];
            unset( $config['class'] ); // lock manager won't need this
            $this->managers[$name] = [
                'class' => $class,
                'config' => $config,
                'instance' => null
            ];
        }
    }
 
    public function get( $name ) {
        if ( !isset( $this->managers[$name] ) ) {
            throw new InvalidArgumentException( "No lock manager defined with the name `$name`." );
        }
        // Lazy-load the actual lock manager instance
        if ( !isset( $this->managers[$name]['instance'] ) ) {
            $class = $this->managers[$name]['class'];
            '@phan-var class-string<LockManager> $class';
            $config = $this->managers[$name]['config'];
            $config['logger'] = LoggerFactory::getInstance( 'LockManager' );
 
            $this->managers[$name]['instance'] = new $class( $config );
        }
 
        return $this->managers[$name]['instance'];
    }
 
    public function config( $name ) {
        if ( !isset( $this->managers[$name] ) ) {
            throw new InvalidArgumentException( "No lock manager defined with the name `$name`." );
        }
        $class = $this->managers[$name]['class'];
 
        return [ 'class' => $class ] + $this->managers[$name]['config'];
    }
}