MessageGroupFactory.php

<?php
declare( strict_types = 1 );
 
namespace MediaWiki\Extension\Translate\MessageGroupConfiguration;
 
use InvalidArgumentException;
use MediaWiki\Extension\Translate\MessageGroups\MessageGroup;
use MediaWiki\Extension\Translate\MessageGroups\MessageGroupBase;
 
class MessageGroupFactory {
    public function __construct(
        private readonly MessageGroupTypeRegistry $typeRegistry
    ) {
    }
 
    public function createGroup( array $conf ): MessageGroup {
        $class = $this->resolveClass( $conf );
        return $this->instantiate( $class, $conf );
    }
 
    public function resolveClass( array $conf ): string {
        $basic = $conf['BASIC'] ?? [];
        $hasType = isset( $basic['type'] );
        $hasClass = isset( $basic['class'] );
 
        if ( $hasType && $hasClass ) {
            throw new InvalidGroupConfigurationException(
                "Message group configuration must not specify both 'type' and 'class' " .
                "(group id: '{$basic['id']}')"
            );
        }
 
        if ( !$hasType && !$hasClass ) {
            throw new InvalidGroupConfigurationException(
                "Message group configuration must specify either 'type' or 'class' " .
                "(group id: '{$basic['id']}')"
            );
        }
 
        if ( $hasType ) {
            return $this->typeRegistry->getClass( $basic['type'] );
        }
 
        return $basic['class'];
    }
 
    private function instantiate( string $class, array $conf ): MessageGroup {
        if ( !class_exists( $class ) ) {
            throw new InvalidArgumentException(
                "Message group implementation class '$class' does not exist or cannot be autoloaded"
            );
        }
 
        if ( !is_subclass_of( $class, MessageGroupBase::class ) ) {
            throw new InvalidArgumentException(
                "Message group implementation class '$class' must extend MessageGroupBase"
            );
        }
 
        return MessageGroupBase::newFromConf( $class, $conf );
    }
}