phil/locale-dimensions

alpha

Des locales, des versions et des chaînes de repli déclarées entre locales, en objets valeur simples.

phil/locale-dimensions donne à une application les trois choses dont a besoin chaque fiche traduite ou versionnée, et qu'il est facile de rater de peu : une Locale à une seule graphie (fr, fr_CA), une Version comptée à partir de un, et une FallbackChain — les locales essayées, dans l'ordre, quand la locale demandée n'a rien à servir. DeclaredLocales construit les chaînes à partir du tableau que déclare une application, en refusant une locale de repli qu'elle ne sert pas.

Elle existe parce que les mêmes questions reviennent dans chaque paquet qui sert plus d'une langue : les pages de contenu, les champs traduits d'un produit ou d'un événement, un plan de site et ses variantes hreflang, les textes d'une interface. Si chacun y répond seul, fr-CA et fr_CA finissent en deux lignes, une traduction manquante tombe dans la langue par défaut alors que la variante régionale est à une ligne de là, et une version zéro veut dire « rien encore » à un endroit et une vraie ligne à un autre. Un seul jeu d'objets valeur les garde d'accord.

C'est une librairie PHP simple, sans dépendance. Elle ne conserve rien et ne lit aucune requête : un bundle lit les locales déclarées dans sa configuration, l'application choisit la locale demandée, et la chaîne dit quoi servir.

État

Partie	État
`Locale`, `Version`	Implémentées et testées
`FallbackChain`, `DeclaredLocales`	Implémentées et testées
`Exception\InvalidLocaleDimension`	Implémentée et testée

Documentation

Document	Contenu
Installation	Les prérequis et l'installation.
Référence	Chaque type public : la graphie d'une locale, la numérotation des versions, les chaînes et leur résolution, les locales déclarées, les refus.
Points d'extension	Comment un bundle déclare ses locales, et comment une lecture parcourt une chaîne.
Tests	Comment la librairie est testée.

Démarrage rapide

use Phil\LocaleDimensions\{DeclaredLocales, Locale, Version};

$locales = DeclaredLocales::fromArray([
    'fr_CA' => ['fr', 'en'],
    'fr' => ['en'],
    'en' => [],
]);

$chain = $locales->chainFor(Locale::fromString('fr_CA'));
$chain->toString();                                       // 'fr_CA → fr → en'
$served = $chain->resolve([Locale::fromString('en'), Locale::fromString('fr')]);   // fr
$chain->leavesRequestedLanguage($served);                 // false: still French
$served->toLanguageTag();                                 // 'fr', for hreflang

Version::first()->next()->number;                         // 2

Prérequis

PHP 8.5 ou une version plus récente.

Contribuer

Les contributions sont les bienvenues sur le monodépôt de PHIL : lisez le guide de contribution et le code de conduite, en anglais. Signalez une vulnérabilité en privé, comme l'explique la politique de sécurité, jamais dans un ticket public.

État

Documentation

Démarrage rapide

Prérequis

Contribuer

Licence