123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184 |
- <?php
- /*
- * This file is part of the Symfony package.
- *
- * (c) Fabien Potencier <fabien@symfony.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
- namespace Symfony\Component\Intl;
- use Symfony\Component\Intl\Exception\MissingResourceException;
- /**
- * Gives access to language-related ICU data.
- *
- * @author Bernhard Schussek <bschussek@gmail.com>
- * @author Roland Franssen <franssen.roland@gmail.com>
- */
- final class Languages extends ResourceBundle
- {
- /**
- * Returns all available languages as two-letter codes.
- *
- * Languages are returned as lowercase ISO 639-1 two-letter language codes.
- * For languages that don't have a two-letter code, the ISO 639-2
- * three-letter code is used instead.
- *
- * A full table of ISO 639 language codes can be found here:
- * http://www-01.sil.org/iso639-3/codes.asp
- *
- * @return string[] an array of canonical ISO 639-1 language codes
- */
- public static function getLanguageCodes(): array
- {
- return self::readEntry(['Languages'], 'meta');
- }
- public static function exists(string $language): bool
- {
- try {
- self::readEntry(['Names', $language]);
- return true;
- } catch (MissingResourceException $e) {
- return false;
- }
- }
- /**
- * Gets the language name from its alpha2 code.
- *
- * A full locale may be passed to obtain a more localized language name, e.g. "American English" for "en_US".
- *
- * @throws MissingResourceException if the language code does not exist
- */
- public static function getName(string $language, string $displayLocale = null): string
- {
- try {
- return self::readEntry(['Names', $language], $displayLocale);
- } catch (MissingResourceException $e) {
- try {
- return self::readEntry(['LocalizedNames', $language], $displayLocale);
- } catch (MissingResourceException $e) {
- if (false !== $i = strrpos($language, '_')) {
- return self::getName(substr($language, 0, $i), $displayLocale);
- }
- throw $e;
- }
- }
- }
- /**
- * Gets the list of language names indexed with alpha2 codes as keys.
- *
- * @return string[]
- */
- public static function getNames(string $displayLocale = null): array
- {
- return self::asort(self::readEntry(['Names'], $displayLocale), $displayLocale);
- }
- /**
- * Returns the ISO 639-2 three-letter code of a language, given a two-letter code.
- *
- * @throws MissingResourceException if the language has no corresponding three-letter code
- */
- public static function getAlpha3Code(string $language): string
- {
- return self::readEntry(['Alpha2ToAlpha3', $language], 'meta');
- }
- /**
- * Returns the ISO 639-1 two-letter code of a language, given a three letter code.
- *
- * @throws MissingResourceException if the language has no corresponding three-letter code
- */
- public static function getAlpha2Code(string $language): string
- {
- return self::readEntry(['Alpha3ToAlpha2', $language], 'meta');
- }
- /**
- * Returns all available languages as three-letter codes.
- *
- * Languages are returned as lowercase ISO 639-2 three-letter language codes.
- *
- * @return string[] an array of canonical ISO 639-2 language codes
- */
- public static function getAlpha3Codes(): array
- {
- return self::readEntry(['Alpha3Languages'], 'meta');
- }
- /**
- * @param string $language ISO 639-2 three-letter language code
- */
- public static function alpha3CodeExists(string $language): bool
- {
- try {
- self::getAlpha2Code($language);
- return true;
- } catch (MissingResourceException $e) {
- static $cache;
- if (null === $cache) {
- $cache = array_flip(self::getAlpha3Codes());
- }
- return isset($cache[$language]);
- }
- }
- /**
- * Gets the language name from its ISO 639-2 three-letter code.
- *
- * @throws MissingResourceException if the country code does not exists
- */
- public static function getAlpha3Name(string $language, string $displayLocale = null): string
- {
- try {
- return self::getName(self::getAlpha2Code($language), $displayLocale);
- } catch (MissingResourceException $e) {
- if (3 === \strlen($language)) {
- return self::getName($language, $displayLocale);
- }
- throw $e;
- }
- }
- /**
- * Gets the list of language names indexed with ISO 639-2 three-letter codes as keys.
- *
- * Same as method getNames, but with ISO 639-2 three-letter codes instead of ISO 639-1 codes as keys.
- *
- * @return string[]
- */
- public static function getAlpha3Names($displayLocale = null): array
- {
- $alpha2Names = self::getNames($displayLocale);
- $alpha3Names = [];
- foreach ($alpha2Names as $alpha2Code => $name) {
- if (3 === \strlen($alpha2Code)) {
- $alpha3Names[$alpha2Code] = $name;
- continue;
- }
- try {
- $alpha3Names[self::getAlpha3Code($alpha2Code)] = $name;
- } catch (MissingResourceException $e) {
- }
- }
- return $alpha3Names;
- }
- protected static function getPath(): string
- {
- return Intl::getDataDirectory().'/'.Intl::LANGUAGE_DIR;
- }
- }
|