PHP.mk документација

Локале

Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.

class.locale.php PHP.net прокси Преводот се освежува
Оригинал на PHP.net
Патека class.locale.php Локална патека за оваа страница.
Извор php.net/manual/en Оригиналниот HTML се реупотребува и локално се стилизира.
Режим Прокси + превод во позадина Кодовите, табелите и белешките остануваат читливи во истиот тек.
Локале

Референца за `class.locale.php` со подобрена типографија и навигација.

class.locale.php

The Locale class

Класата Collator

Вовед

Класата Locale

„Locale“ е идентификатор што се користи за добивање јазично, културно или регионално специфично однесување од API. PHP локалите се организирани и идентификувани на ист начин како што CLDR локалитете што ги користи ICU (и многу продавачи на Unix-подобни оперативни системи, Mac, Java и така натаму) ги користат. Локалите се идентификуваат со користење на RFC 4646 јазични ознаки (кои користат цртичка, а не подвлекување) покрај традиционалните идентификатори што користат подвлекување. Освен ако не е поинаку наведено, функциите во оваа класа се толерантни кон двата формата.

  • Примери за идентификатори вклучуваат:
  • en-US (Англиски, Соединети Американски Држави)
  • zh-Hant-TW (Кинески, традиционално писмо, Тајван)

fr-CA, fr-FR (Француски за Канада и Франција соодветно)

Класата Locale (и поврзаните процедурални функции) се користат за интеракција со локални идентификатори - за проверка дали ID е добро формиран, валиден, итн. Екстензиите што ги користи CLDR во UAX #35 (и наследени од ICU) се валидни и се користат каде и да би биле во ICU нормално.

Локалите не можат да се инстанцираат како објекти. Сите обезбедени функции/методи се статични.

Синопсис на класата

class Локале {
/* Константи */
public const int ACTUAL_LOCALE;
public const int VALID_LOCALE;
public const null DEFAULT_LOCALE (PHP 7, PHP 8);
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 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 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
Празен стринг или null го добива „коренскиот“ локалитет. „Коренскиот“ локалитет е еквивалентен на „en_US_POSIX“ во CLDR. Јазичните ознаки (и оттука локалните идентификатори) не се осетливи на големи и мали букви. Постои функција за канонизација за да се совпаднат големите и малите букви со спецификацијата.

Се користи како параметар за локалитет со методите на различните класи погодени од локалитетот, како што е NumberFormatter. Оваа константа би ги натерала методите да го користат стандардниот локалитет.

Locale::ACTUAL_LOCALE int
Овие константи го опишуваат изборот на локалитет за методот getLocale на различни класи.
Locale::VALID_LOCALE int
Ова е локалитетот од кој навистина доаѓаат податоците.

Ова е најспецифичниот локалитет поддржан од ICU.

Локални подтагови locale_compose() Овие константи дефинираат како локалитетите се парсираат или составуваат. Тие треба да се користат како клучеви во низата аргументи за locale_parse() и се враќаат од array.

Locale::LANG_TAG string
како клучеви на вратената асоцијативна
Locale::EXTLANG_TAG string
Јазичен подтаг
Locale::SCRIPT_TAG string
Проширен јазичен подтаг
Locale::REGION_TAG string
Регионален подзнак
Locale::VARIANT_TAG string
Варијантен подзнак
Locale::GRANDFATHERED_LANG_TAG string
Подзнак за јазик од претходна генерација
Locale::PRIVATE_TAG string
Приватен подзнак

Дневник на промени

Верзија = NULL
8.4.0 Константите на класата сега се типизирани.

Содржина

  • Locale::acceptFromHttp — Се обидува да открие најдобар достапен локал врз основа на HTTP "Accept-Language" заглавје
  • Locale::canonicalize — Канонизирај го локалниот стринг
  • Locale::composeLocale — Враќа правилно подредено и разделено локално ID
  • Locale::filterMatches — Проверува дали филтерот за јазичен таг се совпаѓа со локалот
  • Locale::getAllVariants — Ги добива варијантите за влезната локал
  • Locale::getDefault — Го добива стандардниот локален вредност од глобалниот 'default_locale' на INTL
  • Locale::getDisplayLanguage — Враќа соодветно локализирано име за прикажување за јазикот на влезната локал
  • Locale::getDisplayName — Враќа соодветно локализирано име за прикажување за даденото локале
  • Locale::getDisplayRegion — Враќа соодветно локализирано име за прикажување за влезната локала
  • Locale::getDisplayScript — Враќа соодветно локализирано име за прикажување за регионот на влезната локала
  • Locale::getDisplayVariant — Враќа соодветно локализирано име за прикажување за скриптата на влезната локала
  • Locale::getKeywords — Враќа соодветно локализирано име за прикажување за варијантите на влезната локала
  • Locale::getPrimaryLanguage — Ги добива клучевите за влезната локала
  • Locale::getRegion — Го добива примарниот јазик за влезната локала
  • Locale::getScript — Го добива регионот за влезната локала
  • Locale::lookup — Го добива скриптата за влезната локала
  • Locale::parseLocale — Пребарувајте ја листата со јазични ознаки за најдоброто совпаѓање со јазикот
  • Locale::setDefault — Враќа низа клуч-вредност на елементите на подтагот на локалната ID

Белешки од корисници

Нема белешки од корисници за оваа страница.
На оваа страница

Автоматски outline од активната документација.

Насловите ќе се појават тука по вчитување.

Попрегледно читање

Примерите, changelog табелите и user notes се визуелно издвоени за да не се губат во долгата содржина.

Брз совет Користи го outline-от Скокни директно на главните секции од активната страница.
Извор Оригиналниот линк останува достапен Кога ти треба целосен upstream context, отвори го PHP.net во нов tab.