array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'class.locale.php', 1 => 'Locale', 2 => 'Класс Locale', ), 'up' => array ( 0 => 'book.intl.php', 1 => 'intl', ), 'prev' => array ( 0 => 'numberformatter.settextattribute.php', 1 => 'NumberFormatter::setTextAttribute', ), 'next' => array ( 0 => 'locale.acceptfromhttp.php', 1 => 'Locale::acceptFromHttp', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/intl/locale.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/class.locale.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Класс Locale

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

Введение

Locale — идентификатор, через который из API получают информацию о языке, культуре или региональном поведении. Локали PHP организованы и обозначены так же, как и локали проекта CLDR, которыми пользуется проект ICU и многие производители систем Unix, Linux и Mac, Java и т. д. Локали обозначаются согласно языковым меткам стандарта RFC 4646 (который использует тире, а не подчёркивание) в дополнение к традиционным обозначением с символом подчёркивания. Функции класса понимают оба написания, если явно не указали иное.

Примеры идентификаторов:

  • en-US (Английский, США)
  • zh-Hant-TW (Китайский, Традиционное начертание, Тайвань)
  • fr-CA, fr-FR (Французский для Канады и Франции)

Класс Locale (и соответствующие процедурные функции) используется для взаимодействия с идентификаторами локалей, для проверки правильного составления идентификатора, его корректности и т. д. Модули используются CLDR в UAX #35 (и наследуется ICU), являются корректными и используются везде они были бы в ICU.

Данный класс нельзя инстанциировать как объект. Все методы/функции объявлены статическими.

null или пустая строка будут считаться за «базовую» локаль. «Базовая» локаль — «en_US_POSIX» в проекте CLDR. Языковые метки (и идентификаторы локали) регистронезависимы. В классе присутствует метод, который преобразует их к каноничному виду.

Обзор класса

class Locale {
/* Константы */
public const int ACTUAL_LOCALE;
public const int VALID_LOCALE;
public const null DEFAULT_LOCALE = null;
public const string LANG_TAG;
public const string EXTLANG_TAG;
public const string SCRIPT_TAG;
public const string REGION_TAG;
public const string VARIANT_TAG;
public const string GRANDFATHERED_LANG_TAG;
public const string PRIVATE_TAG;
/* Методы */
public static acceptFromHttp(string $header): string|false
public static canonicalize(string $locale): ?string
public static composeLocale(array $subtags): string|false
public static filterMatches(string $languageTag, string $locale, bool $canonicalize = false): ?bool
public static getAllVariants(string $locale): ?array
public static getDefault(): string
public static getDisplayLanguage(string $locale, ?string $displayLocale = null): string|false
public static getDisplayName(string $locale, ?string $displayLocale = null): string|false
public static getDisplayRegion(string $locale, ?string $displayLocale = null): string|false
public static getDisplayScript(string $locale, ?string $displayLocale = null): string|false
public static getDisplayVariant(string $locale, ?string $displayLocale = null): string|false
public static getKeywords(string $locale): array|false|null
public static getPrimaryLanguage(string $locale): ?string
public static getRegion(string $locale): ?string
public static getScript(string $locale): ?string
public static isRightToLeft( string $locale = "" ): bool
public static lookup(
    array $languageTag,
    string $locale,
    bool $canonicalize = false,
    ?string $defaultLocale = null
): ?string
public static parseLocale(string $locale): ?array
public static setDefault(string $locale): true
}

Предопределённые константы

Locale::DEFAULT_LOCALE null
Используется в качестве параметра, задающего локаль в функциях где это необходимо, таких как NumberFormatter. Эта константа вынуждает использовать локаль по умолчанию.

Эти константы описывают выбор локали для метода getLocale различных классов.

Locale::ACTUAL_LOCALE int
Описывает текущую локаль.
Locale::VALID_LOCALE int
Это самая специфичная локаль, поддерживаемая ICU.

Подтеги локали

Эти константы определяют, как анализируются или составляются локали. Их следует задавать как ключи массива аргументов для функции locale_compose() и возвращать как ключи возвращаемого ассоциативного массива (array) функции locale_parse().

Locale::LANG_TAG int
Подтег языка
Locale::EXTLANG_TAG int
Расширенный подтег языка
Locale::SCRIPT_TAG int
Подтег начертания
Locale::REGION_TAG int
Подтег региона
Locale::VARIANT_TAG int
Подтег варианта
Locale::GRANDFATHERED_LANG_TAG int
Подтег языка в старом синтаксисе (grandfathered)
Locale::PRIVATE_TAG int
Частный подтег

Список изменений

Версия Описание
8.4.0 Константы класса стали типизированными.

Содержание