Jump to content

Manuel:$wgRequest

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

Vue d’ensemble

$wgRequest est utilisé comme un singleton global qui contient une instance de la classe WebRequest. La classe WebRequest encapsule l’obtention des données passées dans l’URL ou via un formulaire POST, la gestion de la suppression des barres obliques « guillemets magiques », le dépouillement des caractères d’entrée illégaux et la normalisation des séquences Unicode. Voir la documentation de la classe WebRequest et Manuel:WebRequest.php pour plus de détails.

Exemples

Ce code peut être utile dans les fonctions d'accroches lorsque vous voulez retourner sans exécuter de code de fonction supplémentaire si l’utilisateur modifie la page en cours plutôt qu'il ne la visualise.

global $wgRequest;
if ( $wgRequest->getText( 'action' ) == 'edit'  ) {
	return true;
}

Dépréciation

Comme pour les autres variables globales, l’utilisation de $wgRequest doit être évitée lorsque d’autres méthodes sont disponibles. Par exemple, lorsque vous écrivez une special page, utilisez la méthode getRequest() fournie par la classe SpecialPage, par exemple :

$request = $this->getRequest();

Accessing

Hook functions

Lorsque vous travaillez avec différentes accroches, vous pouvez généralement obtenir l’objet WebRequest à partir du contexte, par exemple :

$output->getRequest(); // ici $output est un objet de classe OutputPage
$article->getContext()->getRequest(); // obtenir WebRequest à partir de l’objet Article
$editpage->getArticle()->getContext()->getRequest(); // obtenir WebRequest à partir de l’objet EditPage

Pages spéciales

Dans le contexte d'une page spéciale, on peut utiliser $this->getRequest().

Modules API

Dans le contexte d'un module API, on peut utiliser $this->getMain()->getRequest().

Voir aussi