Manual:$wgRequest
Objeto global: $wgRequest | |
---|---|
Objeto WebRequest, initializado em $Setup. | |
Classe: | WebRequest |
Localizado em: | WebRequest.php |
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()
.