You are here

class LanguageManager in Drupal 9

Same name and namespace in other branches
  1. 8 core/lib/Drupal/Core/Language/LanguageManager.php \Drupal\Core\Language\LanguageManager

Class responsible for providing language support on language-unaware sites.

Hierarchy

Expanded class hierarchy of LanguageManager

10 files declare their use of LanguageManager
ActiveLinkResponseFilterTest.php in core/tests/Drupal/Tests/Core/EventSubscriber/ActiveLinkResponseFilterTest.php
ConfigurableLanguage.php in core/modules/language/src/Entity/ConfigurableLanguage.php
ConfigurableLanguageManager.php in core/modules/language/src/ConfigurableLanguageManager.php
install.core.inc in core/includes/install.core.inc
API functions for installing Drupal.
InstallerLanguagePageTest.php in core/tests/Drupal/FunctionalTests/Installer/InstallerLanguagePageTest.php

... See full list

1 string reference to 'LanguageManager'
core.services.yml in core/core.services.yml
core/core.services.yml
1 service uses LanguageManager
language_manager in core/core.services.yml
Drupal\Core\Language\LanguageManager

File

core/lib/Drupal/Core/Language/LanguageManager.php, line 12

Namespace

Drupal\Core\Language
View source
class LanguageManager implements LanguageManagerInterface {
  use DependencySerializationTrait;

  /**
   * A static cache of translated language lists.
   *
   * Array of arrays to cache the result of self::getLanguages() keyed by the
   * language the list is translated to (first level) and the flags provided to
   * the method (second level).
   *
   * @var \Drupal\Core\Language\LanguageInterface[]
   *
   * @see \Drupal\Core\Language\LanguageManager::getLanguages()
   */
  protected $languages = [];

  /**
   * The default language object.
   *
   * @var \Drupal\Core\Language\LanguageDefault
   */
  protected $defaultLanguage;

  /**
   * Constructs the language manager.
   *
   * @param \Drupal\Core\Language\LanguageDefault $default_language
   *   The default language.
   */
  public function __construct(LanguageDefault $default_language) {
    $this->defaultLanguage = $default_language;
  }

  /**
   * {@inheritdoc}
   */
  public function isMultilingual() {
    return FALSE;
  }

  /**
   * {@inheritdoc}
   */
  public function getLanguageTypes() {
    return [
      LanguageInterface::TYPE_INTERFACE,
      LanguageInterface::TYPE_CONTENT,
      LanguageInterface::TYPE_URL,
    ];
  }

  /**
   * Returns information about all defined language types.
   *
   * Defines the three core language types:
   * - Interface language is the only configurable language type in core. It is
   *   used by t() as the default language if none is specified.
   * - Content language is by default non-configurable and inherits the
   *   interface language negotiated value. It is used by the Field API to
   *   determine the display language for fields if no explicit value is
   *   specified.
   * - URL language is by default non-configurable and is determined through the
   *   URL language negotiation method or the URL fallback language negotiation
   *   method if no language can be detected. It is used by l() as the default
   *   language if none is specified.
   *
   * @return array
   *   An associative array of language type information arrays keyed by
   *   language type machine name, in the format of
   *   hook_language_types_info().
   */
  public function getDefinedLanguageTypesInfo() {
    $this->definedLanguageTypesInfo = [
      LanguageInterface::TYPE_INTERFACE => [
        'name' => new TranslatableMarkup('Interface text'),
        'description' => new TranslatableMarkup('Order of language detection methods for interface text. If a translation of interface text is available in the detected language, it will be displayed.'),
        'locked' => TRUE,
      ],
      LanguageInterface::TYPE_CONTENT => [
        'name' => new TranslatableMarkup('Content'),
        'description' => new TranslatableMarkup('Order of language detection methods for content. If a version of content is available in the detected language, it will be displayed.'),
        'locked' => TRUE,
      ],
      LanguageInterface::TYPE_URL => [
        'locked' => TRUE,
      ],
    ];
    return $this->definedLanguageTypesInfo;
  }

  /**
   * {@inheritdoc}
   */
  public function getCurrentLanguage($type = LanguageInterface::TYPE_INTERFACE) {
    return $this
      ->getDefaultLanguage();
  }

  /**
   * {@inheritdoc}
   */
  public function reset($type = NULL) {
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function getDefaultLanguage() {
    return $this->defaultLanguage
      ->get();
  }

  /**
   * {@inheritdoc}
   */
  public function getLanguages($flags = LanguageInterface::STATE_CONFIGURABLE) {
    $static_cache_id = $this
      ->getCurrentLanguage()
      ->getId();
    if (!isset($this->languages[$static_cache_id][$flags])) {

      // If this language manager is used, there are no configured languages.
      // The default language and locked languages comprise the full language
      // list.
      $default = $this
        ->getDefaultLanguage();
      $languages = [
        $default
          ->getId() => $default,
      ];
      $languages += $this
        ->getDefaultLockedLanguages($default
        ->getWeight());

      // Filter the full list of languages based on the value of $flags.
      $this->languages[$static_cache_id][$flags] = $this
        ->filterLanguages($languages, $flags);
    }
    return $this->languages[$static_cache_id][$flags];
  }

  /**
   * {@inheritdoc}
   */
  public function getNativeLanguages() {

    // In a language unaware site we don't have translated languages.
    return $this
      ->getLanguages();
  }

  /**
   * {@inheritdoc}
   */
  public function getLanguage($langcode) {
    $languages = $this
      ->getLanguages(LanguageInterface::STATE_ALL);
    return isset($languages[$langcode]) ? $languages[$langcode] : NULL;
  }

  /**
   * {@inheritdoc}
   */
  public function getLanguageName($langcode) {
    if ($langcode == LanguageInterface::LANGCODE_NOT_SPECIFIED) {
      return new TranslatableMarkup('None');
    }
    if ($language = $this
      ->getLanguage($langcode)) {
      return $language
        ->getName();
    }
    if (empty($langcode)) {
      return new TranslatableMarkup('Unknown');
    }
    return new TranslatableMarkup('Unknown (@langcode)', [
      '@langcode' => $langcode,
    ]);
  }

  /**
   * {@inheritdoc}
   */
  public function getDefaultLockedLanguages($weight = 0) {
    $languages = [];
    $locked_language = [
      'default' => FALSE,
      'locked' => TRUE,
      'direction' => LanguageInterface::DIRECTION_LTR,
    ];

    // This is called very early while initializing the language system. Prevent
    // early t() calls by using the TranslatableMarkup.
    $languages[LanguageInterface::LANGCODE_NOT_SPECIFIED] = new Language([
      'id' => LanguageInterface::LANGCODE_NOT_SPECIFIED,
      'name' => new TranslatableMarkup('Not specified'),
      'weight' => ++$weight,
    ] + $locked_language);
    $languages[LanguageInterface::LANGCODE_NOT_APPLICABLE] = new Language([
      'id' => LanguageInterface::LANGCODE_NOT_APPLICABLE,
      'name' => new TranslatableMarkup('Not applicable'),
      'weight' => ++$weight,
    ] + $locked_language);
    return $languages;
  }

  /**
   * {@inheritdoc}
   */
  public function isLanguageLocked($langcode) {
    $language = $this
      ->getLanguage($langcode);
    return $language ? $language
      ->isLocked() : FALSE;
  }

  /**
   * {@inheritdoc}
   */
  public function getFallbackCandidates(array $context = []) {
    return [
      LanguageInterface::LANGCODE_DEFAULT,
    ];
  }

  /**
   * {@inheritdoc}
   */
  public function getLanguageSwitchLinks($type, Url $url) {
    return [];
  }

  /**
   * {@inheritdoc}
   */
  public static function getStandardLanguageList() {

    // This list is based on languages available from localize.drupal.org. See
    // http://localize.drupal.org/issues for information on how to add languages
    // there.
    //
    // The "Left-to-right marker" comments and the enclosed UTF-8 markers are to
    // make otherwise strange looking PHP syntax natural (to not be displayed in
    // right to left). See https://www.drupal.org/node/128866#comment-528929.
    // cSpell:disable
    return [
      'af' => [
        'Afrikaans',
        'Afrikaans',
      ],
      'am' => [
        'Amharic',
        'አማርኛ',
      ],
      'ar' => [
        'Arabic',
        /* Left-to-right marker "‭" */
        'العربية',
        LanguageInterface::DIRECTION_RTL,
      ],
      'ast' => [
        'Asturian',
        'Asturianu',
      ],
      'az' => [
        'Azerbaijani',
        'Azərbaycanca',
      ],
      'be' => [
        'Belarusian',
        'Беларуская',
      ],
      'bg' => [
        'Bulgarian',
        'Български',
      ],
      'bn' => [
        'Bengali',
        'বাংলা',
      ],
      'bo' => [
        'Tibetan',
        'བོད་སྐད་',
      ],
      'bs' => [
        'Bosnian',
        'Bosanski',
      ],
      'ca' => [
        'Catalan',
        'Català',
      ],
      'cs' => [
        'Czech',
        'Čeština',
      ],
      'cy' => [
        'Welsh',
        'Cymraeg',
      ],
      'da' => [
        'Danish',
        'Dansk',
      ],
      'de' => [
        'German',
        'Deutsch',
      ],
      'dz' => [
        'Dzongkha',
        'རྫོང་ཁ',
      ],
      'el' => [
        'Greek',
        'Ελληνικά',
      ],
      'en' => [
        'English',
        'English',
      ],
      'en-x-simple' => [
        'Simple English',
        'Simple English',
      ],
      'eo' => [
        'Esperanto',
        'Esperanto',
      ],
      'es' => [
        'Spanish',
        'Español',
      ],
      'et' => [
        'Estonian',
        'Eesti',
      ],
      'eu' => [
        'Basque',
        'Euskera',
      ],
      'fa' => [
        'Persian, Farsi',
        /* Left-to-right marker "‭" */
        'فارسی',
        LanguageInterface::DIRECTION_RTL,
      ],
      'fi' => [
        'Finnish',
        'Suomi',
      ],
      'fil' => [
        'Filipino',
        'Filipino',
      ],
      'fo' => [
        'Faeroese',
        'Føroyskt',
      ],
      'fr' => [
        'French',
        'Français',
      ],
      'fy' => [
        'Frisian, Western',
        'Frysk',
      ],
      'ga' => [
        'Irish',
        'Gaeilge',
      ],
      'gd' => [
        'Scots Gaelic',
        'Gàidhlig',
      ],
      'gl' => [
        'Galician',
        'Galego',
      ],
      'gsw-berne' => [
        'Swiss German',
        'Schwyzerdütsch',
      ],
      'gu' => [
        'Gujarati',
        'ગુજરાતી',
      ],
      'he' => [
        'Hebrew',
        /* Left-to-right marker "‭" */
        'עברית',
        LanguageInterface::DIRECTION_RTL,
      ],
      'hi' => [
        'Hindi',
        'हिन्दी',
      ],
      'hr' => [
        'Croatian',
        'Hrvatski',
      ],
      'ht' => [
        'Haitian Creole',
        'Kreyòl ayisyen',
      ],
      'hu' => [
        'Hungarian',
        'Magyar',
      ],
      'hy' => [
        'Armenian',
        'Հայերեն',
      ],
      'id' => [
        'Indonesian',
        'Bahasa Indonesia',
      ],
      'is' => [
        'Icelandic',
        'Íslenska',
      ],
      'it' => [
        'Italian',
        'Italiano',
      ],
      'ja' => [
        'Japanese',
        '日本語',
      ],
      'jv' => [
        'Javanese',
        'Basa Java',
      ],
      'ka' => [
        'Georgian',
        'ქართული ენა',
      ],
      'kk' => [
        'Kazakh',
        'Қазақ',
      ],
      'km' => [
        'Khmer',
        'ភាសាខ្មែរ',
      ],
      'kn' => [
        'Kannada',
        'ಕನ್ನಡ',
      ],
      'ko' => [
        'Korean',
        '한국어',
      ],
      'ku' => [
        'Kurdish',
        'Kurdî',
      ],
      'ky' => [
        'Kyrgyz',
        'Кыргызча',
      ],
      'lo' => [
        'Lao',
        'ພາສາລາວ',
      ],
      'lt' => [
        'Lithuanian',
        'Lietuvių',
      ],
      'lv' => [
        'Latvian',
        'Latviešu',
      ],
      'mg' => [
        'Malagasy',
        'Malagasy',
      ],
      'mk' => [
        'Macedonian',
        'Македонски',
      ],
      'ml' => [
        'Malayalam',
        'മലയാളം',
      ],
      'mn' => [
        'Mongolian',
        'монгол',
      ],
      'mr' => [
        'Marathi',
        'मराठी',
      ],
      'ms' => [
        'Bahasa Malaysia',
        'بهاس ملايو',
      ],
      'my' => [
        'Burmese',
        'ဗမာစကား',
      ],
      'ne' => [
        'Nepali',
        'नेपाली',
      ],
      'nl' => [
        'Dutch',
        'Nederlands',
      ],
      'nb' => [
        'Norwegian Bokmål',
        'Norsk, bokmål',
      ],
      'nn' => [
        'Norwegian Nynorsk',
        'Norsk, nynorsk',
      ],
      'oc' => [
        'Occitan',
        'Occitan',
      ],
      'pa' => [
        'Punjabi',
        'ਪੰਜਾਬੀ',
      ],
      'pl' => [
        'Polish',
        'Polski',
      ],
      'pt-pt' => [
        'Portuguese, Portugal',
        'Português, Portugal',
      ],
      'pt-br' => [
        'Portuguese, Brazil',
        'Português, Brasil',
      ],
      'ro' => [
        'Romanian',
        'Română',
      ],
      'ru' => [
        'Russian',
        'Русский',
      ],
      'sco' => [
        'Scots',
        'Scots',
      ],
      'se' => [
        'Northern Sami',
        'Sámi',
      ],
      'si' => [
        'Sinhala',
        'සිංහල',
      ],
      'sk' => [
        'Slovak',
        'Slovenčina',
      ],
      'sl' => [
        'Slovenian',
        'Slovenščina',
      ],
      'sq' => [
        'Albanian',
        'Shqip',
      ],
      'sr' => [
        'Serbian',
        'Српски',
      ],
      'sv' => [
        'Swedish',
        'Svenska',
      ],
      'sw' => [
        'Swahili',
        'Kiswahili',
      ],
      'ta' => [
        'Tamil',
        'தமிழ்',
      ],
      'ta-lk' => [
        'Tamil, Sri Lanka',
        'தமிழ், இலங்கை',
      ],
      'te' => [
        'Telugu',
        'తెలుగు',
      ],
      'th' => [
        'Thai',
        'ภาษาไทย',
      ],
      'tr' => [
        'Turkish',
        'Türkçe',
      ],
      'tyv' => [
        'Tuvan',
        'Тыва дыл',
      ],
      'ug' => [
        'Uyghur',
        /* Left-to-right marker "‭" */
        'ئۇيغۇرچە',
        LanguageInterface::DIRECTION_RTL,
      ],
      'uk' => [
        'Ukrainian',
        'Українська',
      ],
      'ur' => [
        'Urdu',
        /* Left-to-right marker "‭" */
        'اردو',
        LanguageInterface::DIRECTION_RTL,
      ],
      'vi' => [
        'Vietnamese',
        'Tiếng Việt',
      ],
      'xx-lolspeak' => [
        'Lolspeak',
        'Lolspeak',
      ],
      'zh-hans' => [
        'Chinese, Simplified',
        '简体中文',
      ],
      'zh-hant' => [
        'Chinese, Traditional',
        '繁體中文',
      ],
    ];

    // cSpell:enable
  }

  /**
   * The 6 official languages used at the United Nations.
   *
   * This list is based on
   * http://www.un.org/en/sections/about-un/official-languages/index.html and it
   * uses the same format as getStandardLanguageList().
   *
   * @return array
   *   An array with language codes as keys, and English and native language
   *   names as values.
   */
  public static function getUnitedNationsLanguageList() {

    // cSpell:disable
    return [
      'ar' => [
        'Arabic',
        /* Left-to-right marker "‭" */
        'العربية',
        LanguageInterface::DIRECTION_RTL,
      ],
      'zh-hans' => [
        'Chinese, Simplified',
        '简体中文',
      ],
      'en' => [
        'English',
        'English',
      ],
      'fr' => [
        'French',
        'Français',
      ],
      'ru' => [
        'Russian',
        'Русский',
      ],
      'es' => [
        'Spanish',
        'Español',
      ],
    ];

    // cSpell:enable
  }

  /**
   * Sets the configuration override language.
   *
   * This function is a noop since the configuration cannot be overridden by
   * language unless the Language module is enabled. That replaces the default
   * language manager with a configurable language manager.
   *
   * @param \Drupal\Core\Language\LanguageInterface $language
   *   The language to override configuration with.
   *
   * @return $this
   *
   * @see \Drupal\language\ConfigurableLanguageManager::setConfigOverrideLanguage()
   */
  public function setConfigOverrideLanguage(LanguageInterface $language = NULL) {
    return $this;
  }

  /**
   * {@inheritdoc}
   */
  public function getConfigOverrideLanguage() {
    return $this
      ->getCurrentLanguage();
  }

  /**
   * Filters the full list of languages based on the value of the flag.
   *
   * The locked languages are removed by default.
   *
   * @param \Drupal\Core\Language\LanguageInterface[] $languages
   *   Array with languages to be filtered.
   * @param int $flags
   *   (optional) Specifies the state of the languages that have to be returned.
   *   It can be: LanguageInterface::STATE_CONFIGURABLE,
   *   LanguageInterface::STATE_LOCKED, or LanguageInterface::STATE_ALL.
   *
   * @return \Drupal\Core\Language\LanguageInterface[]
   *   An associative array of languages, keyed by the language code.
   */
  protected function filterLanguages(array $languages, $flags = LanguageInterface::STATE_CONFIGURABLE) {

    // STATE_ALL means we don't actually filter, so skip the rest of the method.
    if ($flags == LanguageInterface::STATE_ALL) {
      return $languages;
    }
    $filtered_languages = [];

    // Add the site's default language if requested.
    if ($flags & LanguageInterface::STATE_SITE_DEFAULT) {

      // Setup a language to have the defaults with data appropriate of the
      // default language only for runtime.
      $defaultLanguage = $this
        ->getDefaultLanguage();
      $default = new Language([
        'id' => $defaultLanguage
          ->getId(),
        'name' => new TranslatableMarkup("Site's default language (@lang_name)", [
          '@lang_name' => $defaultLanguage
            ->getName(),
        ]),
        'direction' => $defaultLanguage
          ->getDirection(),
        'weight' => $defaultLanguage
          ->getWeight(),
      ]);
      $filtered_languages[LanguageInterface::LANGCODE_SITE_DEFAULT] = $default;
    }
    foreach ($languages as $id => $language) {
      if ($language
        ->isLocked() && $flags & LanguageInterface::STATE_LOCKED || !$language
        ->isLocked() && $flags & LanguageInterface::STATE_CONFIGURABLE) {
        $filtered_languages[$id] = $language;
      }
    }
    return $filtered_languages;
  }

}

Members

Namesort descending Modifiers Type Description Overrides
DependencySerializationTrait::$_entityStorages protected property
DependencySerializationTrait::$_serviceIds protected property
DependencySerializationTrait::__sleep public function 2
DependencySerializationTrait::__wakeup public function 2
LanguageManager::$defaultLanguage protected property The default language object.
LanguageManager::$languages protected property A static cache of translated language lists.
LanguageManager::filterLanguages protected function Filters the full list of languages based on the value of the flag.
LanguageManager::getConfigOverrideLanguage public function Gets the current configuration override language. Overrides LanguageManagerInterface::getConfigOverrideLanguage 1
LanguageManager::getCurrentLanguage public function Returns the current language for the given type. Overrides LanguageManagerInterface::getCurrentLanguage 1
LanguageManager::getDefaultLanguage public function Returns a language object representing the site's default language. Overrides LanguageManagerInterface::getDefaultLanguage
LanguageManager::getDefaultLockedLanguages public function Returns a list of the default locked languages. Overrides LanguageManagerInterface::getDefaultLockedLanguages
LanguageManager::getDefinedLanguageTypesInfo public function Returns information about all defined language types. Overrides LanguageManagerInterface::getDefinedLanguageTypesInfo 1
LanguageManager::getFallbackCandidates public function Returns the language fallback candidates for a given context. Overrides LanguageManagerInterface::getFallbackCandidates 1
LanguageManager::getLanguage public function Returns a language object from the given language code. Overrides LanguageManagerInterface::getLanguage
LanguageManager::getLanguageName public function Produced the printed name for a language for display. Overrides LanguageManagerInterface::getLanguageName
LanguageManager::getLanguages public function Returns a list of languages set up on the site. Overrides LanguageManagerInterface::getLanguages 1
LanguageManager::getLanguageSwitchLinks public function Returns the language switch links for the given language type. Overrides LanguageManagerInterface::getLanguageSwitchLinks 1
LanguageManager::getLanguageTypes public function Returns an array of the available language types. Overrides LanguageManagerInterface::getLanguageTypes 1
LanguageManager::getNativeLanguages public function Returns a list of languages set up on the site in their native form. Overrides LanguageManagerInterface::getNativeLanguages 1
LanguageManager::getStandardLanguageList public static function Some common languages with their English and native names. Overrides LanguageManagerInterface::getStandardLanguageList
LanguageManager::getUnitedNationsLanguageList public static function The 6 official languages used at the United Nations.
LanguageManager::isLanguageLocked public function Checks whether a language is locked. Overrides LanguageManagerInterface::isLanguageLocked
LanguageManager::isMultilingual public function Returns whether or not the site has more than one language added. Overrides LanguageManagerInterface::isMultilingual 1
LanguageManager::reset public function Resets the given language type or all types if none specified. Overrides LanguageManagerInterface::reset 1
LanguageManager::setConfigOverrideLanguage public function Sets the configuration override language. Overrides LanguageManagerInterface::setConfigOverrideLanguage 1
LanguageManager::__construct public function Constructs the language manager. 1