196 lines
5.3 KiB
PHP
196 lines
5.3 KiB
PHP
<?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\Locale;
|
|
|
|
@trigger_error('The '.__NAMESPACE__.'\Locale class is deprecated since version 2.7, to be removed in Symfony 3.0. Use the methods provided by the \Symfony\Component\Intl\Intl class instead.', E_USER_DEPRECATED);
|
|
|
|
use Symfony\Component\Intl\Intl;
|
|
|
|
/**
|
|
* Helper class for dealing with locale strings.
|
|
*
|
|
* @author Bernhard Schussek <bschussek@gmail.com>
|
|
*
|
|
* @deprecated since version 2.3, to be removed in 3.0.
|
|
* Use {@link \Locale} and {@link \Symfony\Component\Intl\Intl} instead.
|
|
*/
|
|
class Locale extends \Locale
|
|
{
|
|
/**
|
|
* Caches the countries in different locales.
|
|
*
|
|
* @var array
|
|
*/
|
|
protected static $countries = array();
|
|
|
|
/**
|
|
* Caches the languages in different locales.
|
|
*
|
|
* @var array
|
|
*/
|
|
protected static $languages = array();
|
|
|
|
/**
|
|
* Caches the different locales.
|
|
*
|
|
* @var array
|
|
*/
|
|
protected static $locales = array();
|
|
|
|
/**
|
|
* Returns the country names for a locale.
|
|
*
|
|
* @param string $locale The locale to use for the country names
|
|
*
|
|
* @return array The country names with their codes as keys
|
|
*
|
|
* @throws \RuntimeException When the resource bundles cannot be loaded
|
|
*/
|
|
public static function getDisplayCountries($locale)
|
|
{
|
|
if (!isset(self::$countries[$locale])) {
|
|
self::$countries[$locale] = Intl::getRegionBundle()->getCountryNames($locale);
|
|
}
|
|
|
|
return self::$countries[$locale];
|
|
}
|
|
|
|
/**
|
|
* Returns all available country codes.
|
|
*
|
|
* @return array The country codes
|
|
*
|
|
* @throws \RuntimeException When the resource bundles cannot be loaded
|
|
*/
|
|
public static function getCountries()
|
|
{
|
|
return array_keys(self::getDisplayCountries(self::getDefault()));
|
|
}
|
|
|
|
/**
|
|
* Returns the language names for a locale.
|
|
*
|
|
* @param string $locale The locale to use for the language names
|
|
*
|
|
* @return array The language names with their codes as keys
|
|
*
|
|
* @throws \RuntimeException When the resource bundles cannot be loaded
|
|
*/
|
|
public static function getDisplayLanguages($locale)
|
|
{
|
|
if (!isset(self::$languages[$locale])) {
|
|
self::$languages[$locale] = Intl::getLanguageBundle()->getLanguageNames($locale);
|
|
}
|
|
|
|
return self::$languages[$locale];
|
|
}
|
|
|
|
/**
|
|
* Returns all available language codes.
|
|
*
|
|
* @return array The language codes
|
|
*
|
|
* @throws \RuntimeException When the resource bundles cannot be loaded
|
|
*/
|
|
public static function getLanguages()
|
|
{
|
|
return array_keys(self::getDisplayLanguages(self::getDefault()));
|
|
}
|
|
|
|
/**
|
|
* Returns the locale names for a locale.
|
|
*
|
|
* @param string $locale The locale to use for the locale names
|
|
*
|
|
* @return array The locale names with their codes as keys
|
|
*
|
|
* @throws \RuntimeException When the resource bundles cannot be loaded
|
|
*/
|
|
public static function getDisplayLocales($locale)
|
|
{
|
|
if (!isset(self::$locales[$locale])) {
|
|
self::$locales[$locale] = Intl::getLocaleBundle()->getLocaleNames($locale);
|
|
}
|
|
|
|
return self::$locales[$locale];
|
|
}
|
|
|
|
/**
|
|
* Returns all available locale codes.
|
|
*
|
|
* @return array The locale codes
|
|
*
|
|
* @throws \RuntimeException When the resource bundles cannot be loaded
|
|
*/
|
|
public static function getLocales()
|
|
{
|
|
return array_keys(self::getDisplayLocales(self::getDefault()));
|
|
}
|
|
|
|
/**
|
|
* Returns the ICU version as defined by the intl extension.
|
|
*
|
|
* @return string|null The ICU version
|
|
*/
|
|
public static function getIntlIcuVersion()
|
|
{
|
|
return Intl::getIcuVersion();
|
|
}
|
|
|
|
/**
|
|
* Returns the ICU Data version as defined by the intl extension.
|
|
*
|
|
* @return string|null The ICU Data version
|
|
*/
|
|
public static function getIntlIcuDataVersion()
|
|
{
|
|
return Intl::getIcuDataVersion();
|
|
}
|
|
|
|
/**
|
|
* Returns the ICU data version that ships with Symfony. If the environment variable USE_INTL_ICU_DATA_VERSION is
|
|
* defined, it will try use the ICU data version as defined by the intl extension, if available.
|
|
*
|
|
* @return string The ICU data version that ships with Symfony
|
|
*/
|
|
public static function getIcuDataVersion()
|
|
{
|
|
return Intl::getIcuDataVersion();
|
|
}
|
|
|
|
/**
|
|
* Returns the directory path of the ICU data that ships with Symfony.
|
|
*
|
|
* @return string The path to the ICU data directory
|
|
*/
|
|
public static function getIcuDataDirectory()
|
|
{
|
|
return Intl::getDataDirectory();
|
|
}
|
|
|
|
/**
|
|
* Returns the fallback locale for a given locale, if any.
|
|
*
|
|
* @param string $locale The locale to find the fallback for.
|
|
*
|
|
* @return string|null The fallback locale, or null if no parent exists
|
|
*/
|
|
protected static function getFallbackLocale($locale)
|
|
{
|
|
if (false === $pos = strrpos($locale, '_')) {
|
|
return;
|
|
}
|
|
|
|
return substr($locale, 0, $pos);
|
|
}
|
|
}
|