Manuel:$wgLang
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 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 )