Manual:MediaWiki.php

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:MediaWiki.php and the translation is 26% complete.

Other languages:
English • ‎español • ‎polski • ‎português do Brasil • ‎čeština • ‎日本語 • ‎한국어

Descrição

Entre outras coisas, este arquivo contém:

  • A função checkInitialQueries que cria um objeto Title dependendo do parâmetro title passado para o arquivo index.php. Se o parâmetro curid for passado, ele substituirá o title. Se o parâmetro curid não for passado e o parâmetro oldid for passado, ele substituirá o title se não for uma página especial.
  • A função performRequestForTitle (antes da versão 1.16 era chamado initialize) que faz a maioria do trabalho. Ela chama:
    • preliminaryChecks
    • handleSpecialCases, e se essa função retornar false:
      • initializeArticle, e
      • performAction se initializeArticle retornou um artigo, ou
      • redirect se initializeArticle 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 por performRequestForTitle) 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
  • A função performAction (chamada por performRequestForTitle) 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âmetro maxlag, e se for o caso, emite uma mensagem de erro. * checkMaxLag($maxLag): 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 the title 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 called performRequestForTitle, and before version 1.16 it was called initialize) 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 performAction if initializeArticle returned an article, or
    • Calls redirect if initializeArticle returned a string.
  • 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
    • A string if it's an interwiki redirect or a redirect to a special page
  • Function performAction (called by performRequest) 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 by run) 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

Ver também