(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
Une "Locale" est un identifiant utilisé pour représenter les comportements régionaux d'une API. Les locales PHP sont organisées et identifiées de la même manière que les CLDR de ICU (et que de nombreux autres éditeurs de système Unix, tels que Mac, Java, etc.). Les locales sont identifiées par les libellés de langage de la RFC 4646 (qui utilise des tirets et pas des soulignés) en plus de la notation traditionnelle avec des soulignés. Sauf contre-indication, les fonctions de cette classe sont capables d'utiliser les deux notations.
Exemple d'identifiants :
La classe Locale et les méthodes associées, sont utilisées pour interagir avec les identifiants locaux : pour vérifier qu'un identifiant est bien formé, valide, etc. Les extensions utilisées par CDR dans UAX #35 et hérité par ICU sont valides, et utilisés à chaque fois qu'elles peuvent l'être dans ICU.
Les locales ne peuvent pas être instanciées. Ce sont toutes des fonctions statiques.
La chaîne null
ou vide permet d'obtenir la locale racine. La racine est l'équivalent
de "en_US_POSIX"
en CLDR. Les libellé de langage (et donc, les
identifiants) sont insensibles à la casse. Il existe une fonction de canonalisation
qui permet d'obtenir la spécification exacte.
Ces constantes définissent le comportement de Locale
Locale::DEFAULT_LOCALE
Ces constantes décrivent le choix de la locale pour la méthode getLocale de différentes classes.
Locale::ACTUAL_LOCALE
Locale::VALID_LOCALE
Ces constantes définissent comment les Locales sont analysées ou composées. Elles doivent être utilisées comme clés dans un tableau d'arguments passé à locale_compose() et sont retournées par locale_parse() comme clés d'un array associatif.
Locale::LANG_TAG
Locale::EXTLANG_TAG
Locale::SCRIPT_TAG
Locale::REGION_TAG
Locale::VARIANT_TAG
Locale::GRANDFATHERED_LANG_TAG
Locale::PRIVATE_TAG