Manuel:MediaWiki.php

From mediawiki.org
This page is a translated version of the page Manual:MediaWiki.php and the translation is 100% complete.

Description

Ce fichier contient entre autre :

  • la fonction run, appelées à partir de index.php. Elle exécute l'instance actuelle de MediaWiki en appelant checkMaxLag, main, triggerJobs et restInPeace.
  • la fonction checkMaxLag vérifie si la valeur maximale de la latence pour les bases de données esclave et supérieure au paramètre maxlag , et si c'est le cas génère un message d'erreur. Utilisé initialement dans les requêtes à api.php , appelé explicitement par ApiMain.php avant la 1.19, bien que depuis la 1.19 il fonctionne pour les requêtes de index.php également.
  • la fonction main qui crée un objet Title en fonction du parametre title passé à index.php. Si le paramètre curid est passé, il remplacera title. Si le paramètre curid n'est pas passé et que le pramètre oldid est fourni, il remplacera title dans le cas des pages autres que les pages spéciales.
  • la fonction performRequest (appelée performRequestForTitle avant la version 1.18 , et initialize avant la version 1.16) réalise la plupart du travail :
    • elle vérifie les titres invalides ou les erreurs d'accès en lecture
    • elle réalise les redirections interwiki et les redirections canoniques
    • s'il s'agit d'une page spéciale, elle appelle le code de la page spéciale
    • elle appelle initializeArticle, et
    • appelle performAction si initializeArticle renvoie un article, ou
    • appelle redirect si initializeArticle renvoie une chaîne de caractères.
  • la fonction initializeArticle crée un objet Article à partir du Title fourni. Puis elle vérifie si c'est une redirection et dans ce cas recrée un autre Article à partir de la cible de la redirection et modifie le $wgTitle . Elle peut renvoyer soit :
    • un objet Article qui sera passé à performAction pour exécuter l'action demandée
    • une chaîne de caractères s'il s'agit d'une redirection interwiki ou une redirection vers une page spéciale
  • la fonction performAction (appelée par performRequest) réalise la plupart des actions dont la génération du HTML. Par exemple dans le cas d'un affichage de page, la fonction view de Article.php est appelée.
  • la fonction restInPeace (appelée par run) réalise :
    • les mises à jour différées
    • la validation (commit) de toutes les transactions sur la base de données
  • la fonction triggerJobs (ou doJobs avant la 1.23) exécute zero, une ou plusieurs tâches issues de la file d'attente, en fonction de $wgJobRunRate . Appelée de run (ou de restInPeace avant la 1.23).

Accroches

Voir aussi