Locales.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Core\Localization;

class Locales implements \TYPO3\CMS\Core\SingletonInterface {

    protected $languages = array(
        'default' => 'English',
        'af' => 'Afrikaans',
        'ar' => 'Arabic',
        'bs' => 'Bosnian',
        'bg' => 'Bulgarian',
        'ca' => 'Catalan',
        'ch' => 'Chinese (Simpl.)',
        'cs' => 'Czech',
        'da' => 'Danish',
        'de' => 'German',
        'el' => 'Greek',
        'eo' => 'Esperanto',
        'es' => 'Spanish',
        'et' => 'Estonian',
        'eu' => 'Basque',
        'fa' => 'Persian',
        'fi' => 'Finnish',
        'fo' => 'Faroese',
        'fr' => 'French',
        'fr_CA' => 'French (Canada)',
        'gl' => 'Galician',
        'he' => 'Hebrew',
        'hi' => 'Hindi',
        'hr' => 'Croatian',
        'hu' => 'Hungarian',
        'is' => 'Icelandic',
        'it' => 'Italian',
        'ja' => 'Japanese',
        'ka' => 'Georgian',
        'kl' => 'Greenlandic',
        'km' => 'Khmer',
        'ko' => 'Korean',
        'lt' => 'Lithuanian',
        'lv' => 'Latvian',
        'ms' => 'Malay',
        'nl' => 'Dutch',
        'no' => 'Norwegian',
        'pl' => 'Polish',
        'pt' => 'Portuguese',
        'pt_BR' => 'Brazilian Portuguese',
        'ro' => 'Romanian',
        'ru' => 'Russian',
        'sk' => 'Slovak',
        'sl' => 'Slovenian',
        'sq' => 'Albanian',
        'sr' => 'Serbian',
        'sv' => 'Swedish',
        'th' => 'Thai',
        'tr' => 'Turkish',
        'uk' => 'Ukrainian',
        'vi' => 'Vietnamese',
        'zh' => 'Chinese (Trad.)'
    );

    protected $isoReverseMapping = array(
        'bs' => 'ba',
        // Bosnian
        'cs' => 'cz',
        // Czech
        'da' => 'dk',
        // Danish
        'el' => 'gr',
        // Greek
        'fr_CA' => 'qc',
        // French (Canada)
        'gl' => 'ga',
        // Galician
        'ja' => 'jp',
        // Japanese
        'ka' => 'ge',
        // Georgian
        'kl' => 'gl',
        // Greenlandic
        'ko' => 'kr',
        // Korean
        'ms' => 'my',
        // Malay
        'pt_BR' => 'br',
        // Portuguese (Brazil)
        'sl' => 'si',
        // Slovenian
        'sv' => 'se',
        // Swedish
        'uk' => 'ua',
        // Ukrainian
        'vi' => 'vn',
        // Vietnamese
        'zh' => 'hk',
        // Chinese (China)
        'zh_CN' => 'ch',
        // Chinese (Simplified)
        'zh_HK' => 'hk'
    );

    protected $isoMapping;

    protected $localeDependencies;

    static public function initialize() {
        $instance = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Core\\Localization\\Locales');
        $instance->isoMapping = array_flip($instance->isoReverseMapping);
        // Allow user-defined locales
        if (isset($GLOBALS['TYPO3_CONF_VARS']['SYS']['localization']['locales']['user']) && is_array($GLOBALS['TYPO3_CONF_VARS']['SYS']['localization']['locales']['user'])) {
            foreach ($GLOBALS['TYPO3_CONF_VARS']['SYS']['localization']['locales']['user'] as $locale => $name) {
                if (!isset($instance->languages[$locale])) {
                    $instance->languages[$locale] = $name;
                }
            }
        }
        // Initializes the locale dependencies with TYPO3 supported locales
        $instance->localeDependencies = array();
        foreach ($instance->languages as $locale => $name) {
            if (strlen($locale) == 5) {
                $instance->localeDependencies[$locale] = array(substr($locale, 0, 2));
            }
        }
        // Merge user-provided locale dependencies
        if (isset($GLOBALS['TYPO3_CONF_VARS']['SYS']['localization']['locales']['dependencies']) && is_array($GLOBALS['TYPO3_CONF_VARS']['SYS']['localization']['locales']['dependencies'])) {
            \TYPO3\CMS\Core\Utility\ArrayUtility::mergeRecursiveWithOverrule($instance->localeDependencies, $GLOBALS['TYPO3_CONF_VARS']['SYS']['localization']['locales']['dependencies']);
        }
    }

    public function getLocales() {
        return array_keys($this->languages);
    }

    public function getLanguages() {
        return $this->languages;
    }

    public function getIsoMapping() {
        return $this->isoMapping;
    }

    public function getTerLocales() {
        return $this->convertToTerLocales(array_keys($this->languages));
    }

    public function getLocaleDependencies($locale) {
        $dependencies = array();
        if (isset($this->localeDependencies[$locale])) {
            $dependencies = $this->localeDependencies[$locale];
            // Search for dependencies recursively
            $localeDependencies = $dependencies;
            foreach ($localeDependencies as $dependency) {
                if (isset($this->localeDependencies[$dependency])) {
                    $dependencies = array_merge($dependencies, $this->getLocaleDependencies($dependency));
                }
            }
        }
        return $dependencies;
    }

    public function getTerLocaleDependencies($locale) {
        $terLocale = isset($this->isoMapping[$locale]) ? $this->isoMapping[$locale] : $locale;
        return $this->convertToTerLocales($this->getLocaleDependencies($terLocale));
    }

    protected function convertToTerLocales(array $locales) {
        $terLocales = array();
        foreach ($locales as $locale) {
            $terLocales[] = isset($this->isoReverseMapping[$locale]) ? $this->isoReverseMapping[$locale] : $locale;
        }
        return $terLocales;
    }

}