LanguageConverterFactory.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Language;
 
use MediaWiki\Config\ServiceOptions;
use MediaWiki\Language\Converters\BanConverter;
use MediaWiki\Language\Converters\CrhConverter;
use MediaWiki\Language\Converters\EnConverter;
use MediaWiki\Language\Converters\GanConverter;
use MediaWiki\Language\Converters\IuConverter;
use MediaWiki\Language\Converters\KuConverter;
use MediaWiki\Language\Converters\MniConverter;
use MediaWiki\Language\Converters\ShConverter;
use MediaWiki\Language\Converters\ShiConverter;
use MediaWiki\Language\Converters\SrConverter;
use MediaWiki\Language\Converters\TgConverter;
use MediaWiki\Language\Converters\TlyConverter;
use MediaWiki\Language\Converters\UzConverter;
use MediaWiki\Language\Converters\WuuConverter;
use MediaWiki\Language\Converters\ZghConverter;
use MediaWiki\Language\Converters\ZhConverter;
use MediaWiki\MainConfigNames;
use MediaWiki\StubObject\StubUserLang;
use Wikimedia\ObjectFactory\ObjectFactory;
 
class LanguageConverterFactory {
 
    private $cache = [];
    private $converterList = [
        'ban' => [
            'class' => BanConverter::class,
        ],
        'crh' => [
            'class' => CrhConverter::class,
        ],
        'gan' => [
            'class' => GanConverter::class,
        ],
        'iu' => [
            'class' => IuConverter::class,
        ],
        'ku' => [
            'class' => KuConverter::class,
        ],
        'mni' => [
            'class' => MniConverter::class,
        ],
        'sh' => [
            'class' => ShConverter::class,
        ],
        'shi' => [
            'class' => ShiConverter::class,
        ],
        'sr' => [
            'class' => SrConverter::class,
        ],
        'tg' => [
            'class' => TgConverter::class,
        ],
        'tly' => [
            'class' => TlyConverter::class,
        ],
        'uz' => [
            'class' => UzConverter::class,
        ],
        'wuu' => [
            'class' => WuuConverter::class,
        ],
        'zgh' => [
            'class' => ZghConverter::class,
        ],
        'zh' => [
            'class' => ZhConverter::class,
        ],
    ];
 
    private const DEFAULT_CONVERTER = [
        'class' => TrivialLanguageConverter::class,
        'services' => [
            'TitleFormatter',
        ]
    ];
 
    private const EN_CONVERTER = [
        'class' => EnConverter::class,
    ];
 
    public const CONSTRUCTOR_OPTIONS = [
        MainConfigNames::UsePigLatinVariant,
        MainConfigNames::DisableLangConversion,
        MainConfigNames::DisableTitleConversion,
    ];
 
    private ServiceOptions $options;
    private ObjectFactory $objectFactory;
 
    private $defaultLanguage;
 
    public function __construct(
        ServiceOptions $options,
        ObjectFactory $objectFactory,
        callable $defaultLanguage
    ) {
        $options->assertRequiredOptions( self::CONSTRUCTOR_OPTIONS );
        $this->options = $options;
        $this->objectFactory = $objectFactory;
        if ( $options->get( MainConfigNames::UsePigLatinVariant ) ) {
            $this->converterList['en'] = self::EN_CONVERTER;
        }
        $this->defaultLanguage = $defaultLanguage;
    }
 
    private function instantiateConverter( $lang ): ILanguageConverter {
        $code = mb_strtolower( $lang->getCode() );
        $spec = $this->converterList[$code] ?? self::DEFAULT_CONVERTER;
        return $this->objectFactory->createObject(
            $spec,
            [
                'assertClass' => ILanguageConverter::class,
                'extraArgs' => [ $lang ],
            ]
        );
    }
 
    public function getLanguageConverter( $language = null ): ILanguageConverter {
        $lang = $language ?? ( $this->defaultLanguage )();
        if ( isset( $this->cache[$lang->getCode()] ) ) {
            return $this->cache[$lang->getCode()];
        }
        // @phan-suppress-next-line PhanTypeMismatchArgumentNullable False positive
        $converter = $this->instantiateConverter( $lang );
        $this->cache[$lang->getCode()] = $converter;
        return $converter;
    }
 
    public function isConversionDisabled() {
        return $this->options->get( MainConfigNames::DisableLangConversion );
    }
 
    public function isLinkConversionDisabled() {
        return $this->options->get( MainConfigNames::DisableLangConversion ) ||
            // Note that this configuration option is misnamed.
            $this->options->get( MainConfigNames::DisableTitleConversion );
    }
}
 
class_alias( LanguageConverterFactory::class, 'MediaWiki\\Languages\\LanguageConverterFactory' );