Manuel:$wgRequest
| Objet global : $wgRequest | |
|---|---|
| Objet WebRequest initialisé en Setup.php. | |
| Classe : | WebRequest |
| Situé dans : | WebRequest.php |
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().