vendor/symfony/intl/Languages.php line 59

Open in your IDE?
  1. <?php
  3. /*
  4.  * This file is part of the Symfony package.
  5.  *
  6.  * (c) Fabien Potencier <fabien@symfony.com>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. namespace Symfony\Component\Intl;
  14. use Symfony\Component\Intl\Exception\MissingResourceException;
  16. /**
  17.  * Gives access to language-related ICU data.
  18.  *
  19.  * @author Bernhard Schussek <bschussek@gmail.com>
  20.  * @author Roland Franssen <franssen.roland@gmail.com>
  21.  */
  22. final class Languages extends ResourceBundle
  23. {
  24.     /**
  25.      * Returns all available languages as two-letter codes.
  26.      *
  27.      * Languages are returned as lowercase ISO 639-1 two-letter language codes.
  28.      * For languages that don't have a two-letter code, the ISO 639-2
  29.      * three-letter code is used instead.
  30.      *
  31.      * A full table of ISO 639 language codes can be found here:
  32.      * http://www-01.sil.org/iso639-3/codes.asp
  33.      *
  34.      * @return string[] an array of canonical ISO 639-1 language codes
  35.      */
  36.     public static function getLanguageCodes(): array
  37.     {
  38.         return self::readEntry(['Languages'], 'meta');
  39.     }
  41.     public static function exists(string $language): bool
  42.     {
  43.         try {
  44.             self::readEntry(['Names', $language]);
  46.             return true;
  47.         } catch (MissingResourceException $e) {
  48.             return false;
  49.         }
  50.     }
  52.     /**
  53.      * Gets the language name from its alpha2 code.
  54.      *
  55.      * A full locale may be passed to obtain a more localized language name, e.g. "American English" for "en_US".
  56.      *
  57.      * @throws MissingResourceException if the language code does not exist
  58.      */
  59.     public static function getName(string $language, ?string $displayLocale = null): string
  60.     {
  61.         try {
  62.             return self::readEntry(['Names', $language], $displayLocale);
  63.         } catch (MissingResourceException $e) {
  64.             try {
  65.                 return self::readEntry(['LocalizedNames', $language], $displayLocale);
  66.             } catch (MissingResourceException $e) {
  67.                 if (false !== $i = strrpos($language, '_')) {
  68.                     return self::getName(substr($language, 0, $i), $displayLocale);
  69.                 }
  71.                 throw $e;
  72.             }
  73.         }
  74.     }
  76.     /**
  77.      * Gets the list of language names indexed with alpha2 codes as keys.
  78.      *
  79.      * @return array<string, string>
  80.      */
  81.     public static function getNames(?string $displayLocale = null): array
  82.     {
  83.         return self::asort(self::readEntry(['Names'], $displayLocale), $displayLocale);
  84.     }
  86.     /**
  87.      * Returns the ISO 639-2 three-letter code of a language, given a two-letter code.
  88.      *
  89.      * @throws MissingResourceException if the language has no corresponding three-letter code
  90.      */
  91.     public static function getAlpha3Code(string $language): string
  92.     {
  93.         return self::readEntry(['Alpha2ToAlpha3', $language], 'meta');
  94.     }
  96.     /**
  97.      * Returns the ISO 639-1 two-letter code of a language, given a three letter code.
  98.      *
  99.      * @throws MissingResourceException if the language has no corresponding three-letter code
  100.      */
  101.     public static function getAlpha2Code(string $language): string
  102.     {
  103.         return self::readEntry(['Alpha3ToAlpha2', $language], 'meta');
  104.     }
  106.     /**
  107.      * Returns all available languages as three-letter codes.
  108.      *
  109.      * Languages are returned as lowercase ISO 639-2 three-letter language codes.
  110.      *
  111.      * @return string[] an array of canonical ISO 639-2 language codes
  112.      */
  113.     public static function getAlpha3Codes(): array
  114.     {
  115.         return self::readEntry(['Alpha3Languages'], 'meta');
  116.     }
  118.     /**
  119.      * @param string $language ISO 639-2 three-letter language code
  120.      */
  121.     public static function alpha3CodeExists(string $language): bool
  122.     {
  123.         try {
  124.             self::getAlpha2Code($language);
  126.             return true;
  127.         } catch (MissingResourceException $e) {
  128.             static $cache;
  129.             if (null === $cache) {
  130.                 $cache = array_flip(self::getAlpha3Codes());
  131.             }
  133.             return isset($cache[$language]);
  134.         }
  135.     }
  137.     /**
  138.      * Gets the language name from its ISO 639-2 three-letter code.
  139.      *
  140.      * @throws MissingResourceException if the country code does not exists
  141.      */
  142.     public static function getAlpha3Name(string $language, ?string $displayLocale = null): string
  143.     {
  144.         try {
  145.             return self::getName(self::getAlpha2Code($language), $displayLocale);
  146.         } catch (MissingResourceException $e) {
  147.             if (3 === \strlen($language)) {
  148.                 return self::getName($language, $displayLocale);
  149.             }
  151.             throw $e;
  152.         }
  153.     }
  155.     /**
  156.      * Gets the list of language names indexed with ISO 639-2 three-letter codes as keys.
  157.      *
  158.      * Same as method getNames, but with ISO 639-2 three-letter codes instead of ISO 639-1 codes as keys.
  159.      *
  160.      * @return array<string, string>
  161.      */
  162.     public static function getAlpha3Names(?string $displayLocale = null): array
  163.     {
  164.         $alpha2Names = self::getNames($displayLocale);
  165.         $alpha3Names = [];
  166.         foreach ($alpha2Names as $alpha2Code => $name) {
  167.             if (3 === \strlen($alpha2Code)) {
  168.                 $alpha3Names[$alpha2Code] = $name;
  169.                 continue;
  170.             }
  171.             try {
  172.                 $alpha3Names[self::getAlpha3Code($alpha2Code)] = $name;
  173.             } catch (MissingResourceException $e) {
  174.             }
  175.         }
  177.         return $alpha3Names;
  178.     }
  180.     protected static function getPath(): string
  181.     {
  182.         return Intl::getDataDirectory().'/'.Intl::LANGUAGE_DIR;
  183.     }
  184. }