Manuel:$wgLang
Appearance
| Objet global : $wgLang | |
|---|---|
| Langue de l'utilisateur | |
| Classe : | Language |
| Situé dans : | Language.php |
Détails
L’objet langue utilisateur est l’objet langue sélectionné dans les préférences utilisateur.
C’est l’un des deux objets language globaux, l’autre était $wgContLang (supprimé en 1.36).
Voir la page Manuel:Langue pour plus d’informations.
$wgLang est initialisé vers la fin de la configuration; certaines accroches sont appelées plus tôt que cela et devraient éviter de l’utiliser.
En cas de doute, utilisez $wgUser->isSafeToLoad() pour vérifier.
Méthodes souvent utilisées
Ceci n’est pas une liste exhaustive, voir la classe ci-dessus pour voir une liste complète.
$wgLang->commaList( $list )- délimiter une liste de chaînes selon les conventions de la langue de l’utilisateur
$wgLang->getCode()- retourner le code de langue de l’utilisateur, par exemple « fr »
Alternative recommandée
Il est préférable que le nouveau code évite d'utiliser les variables globales lorsque des alternatives existent. Dans le cas de $wgLang, deux alternatives existent et peuvent être utilisées :
- Utiliser une instance de la classe
Contextpour obtenir la langue utilisée dans ce contexte, par exemple$contextSource->getLanguage(). (voir aussi les : Acesseurs dans RequestContext.php) - Utiliser
MediaWikiServicespour obtenir la langue du contenu statiquement, par exempleMediaWikiServices::getInstance()->getContentLanguage();. (Voir Dependency Injection pour en savoir plus sur MediaWikiServices)