Manual:MediaWiki.php
Jump to navigation
Jump to search
Outdated translations are marked like this.
Arquivo MediaWiki: MediaWiki.php | |
---|---|
Local: | includes/ |
Código fonte: | master • 1.35.1 • 1.31.12 |
Classes: | MediaWiki |
Descrição
Entre outras coisas, este arquivo contém:
- A função
checkInitialQueries
que cria um objeto Title dependendo do parâmetrotitle
passado para o arquivo index.php. Se o parâmetrocurid
for passado, ele substituirá otitle
. Se o parâmetrocurid
não for passado e o parâmetrooldid
for passado, ele substituirá otitle
se não for uma página especial. - A função
performRequestForTitle
(antes da versão 1.16 era chamadoinitialize
) que faz a maioria do trabalho. Ela chama:preliminaryChecks
handleSpecialCases
, e se essa função retornar false:initializeArticle
, eperformAction
seinitializeArticle
retornou um artigo, ouredirect
seinitializeArticle
retornou uma string.
- A função
preliminaryChecks
, que verifica se a página pode ser vista pelo usuário atual (ao chamar Title::userCanRead()
), e produzirá um erro se não for. - A função
handleSpecialCases
(chamada porperformRequestForTitle
) retorna true se correspondeu um caso especial (veja a lista abaixo) e false se o pedido deve continuar. Casos especiais manipulados por esta função:- Título inválido
- Redirects para links de interwikis
- Local redireciona se, p.ex., nenhum parâmetro título for passado a index.php, ...
- Páginas especiais
- A função
initializeArticle
, que cria um objeto «Artigo» do «Título» determinado. Em seguida, ele verifica se é um redirecionamento e se for o caso, recria um outro «Artigo» do alvo do redirecionamento e altera as variáveis $wgTitle e $wgArticle. Ele pode retornar:- Um objeto artigo, o qual vai ser passado
performAction
para executar a ação solicitada - Uma string se é um redirecionamento interwiki ou um redirecionamento para uma página especial
- Um objeto artigo, o qual vai ser passado
- A função
performAction
(chamada porperformRequestForTitle
) que executa a maioria das ações, incluindo a criação do HTML. Por exemplo, no caso da visualização de uma página, a função "view" em Article.php é chamada. - A função
finalCleanup
(chamada por index.php) que faz o seguinte:- Compromete quaisquer transações de banco de dados
- Elimina todo o código HTML chamando
OutputPage::output()
- Executa atualizações diferidas
- Executa tarefas (ao chamar
doJobs
)
- A função
doJobs
, que é executada do zero, uma ou mais tarefas da fila de tarefas, dependendo da variável $wgJobRunRate. checkMaxLag($maxLag)
: verificar se o atraso máximo de escravos de banco de dados é maior do que o parâmetromaxlag
, e se for o caso, emite uma mensagem de erro. verificar se o atraso máximo de escravos de banco de dados é maior do que a variável $maxLag, e se for o caso, emite uma mensagem de erro. Esta função é utilizada por ApiMain.php.
- Function
main
which creates a Title object depending on thetitle
parameter passed to index.php.
If the curid
parameter is passed, it will override the title
. If the curid
parameter isn't passed and the oldid
parameter is passed, it will override the title
if it's not a special page.
- Function
performRequest
(before version 1.18 it was calledperformRequestForTitle
, and before version 1.16 it was calledinitialize
) which does the most of the work. It:
- Checks for invalid titles, or read permission errors
- Performs interwiki redirects and canonical redirects
- If it's a special page, calls the special page code
- Calls
initializeArticle
, and
- Calls
- Calls
performAction
ifinitializeArticle
returned an article, or
- Calls
- Calls
redirect
ifinitializeArticle
returned a string.
- Calls
- Function
initializeArticle
, which creates an Article object from the Title given.
Then it checks if it is a redirect and if it's the case, recreate another Article from the target of the redirect and changes $wgTitle
and $wgArticle
. It can return either:
- An article object, which will be passed
performAction
to execute the requested action
- An article object, which will be passed
- A string if it's an interwiki redirect or a redirect to a special page
- Function
performAction
(called byperformRequest
) which performs most actions, including creating the HTML.
For example, in the case of viewing a page, function "view" in Article.php is called.
- Function
restInPeace
(called byrun
) which does the following:
- Faz todas as atualizações deferidas.
- Commit any database transactions
- Function
triggerJobs
(doJobs
before 1.23), which runs zero, one or more jobs from the Job queue, depending on$wgJobRunRate
.
Called from run
(it was called from restInPeace
before 1.23).
Ganchos
- ArticleFromTitle (introduzido na 1.8) now is moved into Article.php
- MediaWikiPerformAction (introduzido na 1.12)
- UnknownAction (obsoleto na versão 1.19)(removido na 1.33)
- InitializeArticleMaybeRedirect (introduzido na 1.13)
- CustomEditor (introduzido na 1.9.1) now is moved into EditAction.php
- BeforeInitialize (introduzido na 1.16)