Manuel:$wgLang

From mediawiki.org
This page is a translated version of the page Manual:$wgLang and the translation is 78% complete.

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 du langage global, l’autre étant $wgContLang (supprimé en 1.36). Voir la page Manual:Langue pour plus d’informations.

$wgLang est initialisé vers la fin de la configuration; certains crochets sont appelés 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 :

  • Use an instance of Context class to get the language used in that context, e.g. $contextSource->getLanguage(). (see also: Manual:RequestContext.php#Accessors)
  • Use MediaWikiServices to get the content language statically, e.g. MediaWikiServices::getInstance()->getContentLanguage();. (To read more about MediaWikiServices, see Dependency Injection )