Manual:$wgRequest

This page is a translated version of the page Manual:$wgRequest and the translation is 45% complete.
Outdated translations are marked like this.

Visão global

O objeto $Request é usado como um singleton global que contém uma instância da classe $WebRequest. A classe WebRequest efetua o encapsulamento obtendo dados passados ​​na URL ou através de um formulário POST, lidando com a remoção de barras "magic quotes", removendo caracteres de entrada ilegal e normalizando seqüências Unicode. Veja a $svn documentação da classe e $WebRequest.php para mais detalhes.

Exemplos

Este código pode ser útil dentro de uma função de hook quando você quiser retornar sem executar códigos de função adicional se o usuário está editando, em vez de visualizar, a página atual.

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

Depreciação

Assim como outras variáveis globais, o uso de $wgRequest deve ser evitado quando métodos alternativos estiverem disponíveis. Por exemplo, ao escrever uma página especial, use o método getRequest() fornecido pela classe SpecialPage, p.ex.:

$request = $this->getRequest();

Accessing

Hook functions

Quando você trabalha com vários hooks, geralmente você pode obter o objeto WebRequest a partir do contexto, por exemplo:

$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

In a special page context, one can use $this->getRequest().

API modules

In an API module context, one can use $this->getMain()->getRequest().

See also