LanguageFallback.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Language;
 
class LanguageFallback {
    public const MESSAGES = LanguageFallbackMode::MESSAGES;
 
    public const STRICT = LanguageFallbackMode::STRICT;
 
    private $fallbackCache = [];
 
    public function __construct(
        private readonly string $siteLangCode,
        private readonly LocalisationCache $localisationCache,
        private readonly LanguageNameUtils $langNameUtils,
    ) {
    }
 
    public function getFirst( $code ) {
        return $this->getAll( $code )[0] ?? null;
    }
 
    public function getAll( $code, $mode = LanguageFallbackMode::MESSAGES ) {
        // XXX The LanguageNameUtils dependency is just because of this line, is it needed?
        // Especially because isValidBuiltInCode() is just a one-line regex anyway, maybe it should
        // actually be static?
        if ( $code === 'en' || !$this->langNameUtils->isValidBuiltInCode( $code ) ) {
            return [];
        }
        if ( is_int( $mode ) ) {
            $mode = LanguageFallbackMode::from( $mode );
        }
        return match ( $mode ) {
            LanguageFallbackMode::MESSAGES =>
                // For unknown languages, fallbackSequence returns an empty array. Hardcode fallback
                // to 'en' in that case, as English messages are always defined.
                $this->localisationCache->getItem( $code, 'fallbackSequence' ) ?: [ 'en' ],
 
            LanguageFallbackMode::STRICT =>
                // Use this mode when you don't want to fall back to English unless explicitly
                // defined, for example, when you have language-variant icons and an international
                // language-independent fallback.
                $this->localisationCache->getItem( $code, 'originalFallbackSequence' ),
        };
    }
 
    public function getAllIncludingSiteLanguage( $code ) {
        // Usually, we will only store a tiny number of fallback chains, so we cache in a member.
        $cacheKey = "{$code}-{$this->siteLangCode}";
 
        if ( !array_key_exists( $cacheKey, $this->fallbackCache ) ) {
            $fallbacks = $this->getAll( $code );
 
            if ( $code === $this->siteLangCode ) {
                // Don't bother hitting the localisation cache a second time
                $siteFallbacks = [ $code ];
            } else {
                // Append the site's fallback chain, including the site language itself
                $siteFallbacks = $this->getAll( $this->siteLangCode );
                array_unshift( $siteFallbacks, $this->siteLangCode );
 
                // Eliminate any languages already included in the chain
                $siteFallbacks = array_diff( $siteFallbacks, $fallbacks );
            }
 
            $this->fallbackCache[$cacheKey] = [ $fallbacks, $siteFallbacks ];
        }
        return $this->fallbackCache[$cacheKey];
    }
}
 
class_alias( LanguageFallback::class, 'MediaWiki\\Languages\\LanguageFallback' );