Manual:$wgRequest
Global object: $wgRequest | |
---|---|
WebRequest object, initialized in Setup.php . | |
Class: | WebRequest |
Located in: | WebRequest.php |
Overview
[edit ]$wgRequest
is used as a global singleton that contains an instance of the WebRequest class.
The WebRequest class encapsulates getting at data passed in the URL or via a POSTed form, handling removal of "magic quotes" slashes, stripping illegal input characters and normalizing Unicode sequences.
See the WebRequest class documentation and Manual:WebRequest.php for more details.
Examples
[edit ]This code can be useful within hook functions when you want to return without executing additional function code if the user is editing, rather than viewing, the current page.
global $wgRequest; if ( $wgRequest->getText( 'action' ) == 'edit' ) { return true; }
Deprecation
[edit ]As with other globals, the use of $wgRequest
should be avoided when alternative methods are available.
For example, when writing a special page, use the getRequest()
method provided by the SpecialPage class, e.g.:
$request = $this->getRequest();
Accessing
[edit ]Hook functions
[edit ]When you work with various hooks you can usually get the WebRequest object from the context, for example:
$output->getRequest(); // here $output is an object of OutputPage class $article->getContext()->getRequest(); // getting WebRequest from the Article object $editpage->getArticle()->getContext()->getRequest(); // getting WebRequest from the EditPage object
Special pages
[edit ]In a special page context, one can use $this->getRequest()
.
API modules
[edit ]In an API module context, one can use $this->getMain()->getRequest()
.