Manuel:$wgExtensionFunctions

From mediawiki.org
This page is a translated version of the page Manual:$wgExtensionFunctions and the translation is 100% complete.
Extensions: $wgExtensionFunctions
Une liste de fonctions de rappel (callback) appelées une fois que MediaWiki est complètement initialisé.
Introduit dans la version :1.3.0 (r3583)
Retiré dans la version :Encore utilisé
Valeurs autorisées :Non renseigné
Valeur par défaut :[]

Détails

En général, l'utilisation de cette fonctionalité est un artifice qui suggère que quelque chose ne fonctionne pas correctement quelquepart, soit dans le noyau de MediaWiki, soit dans les extensions. Elle doit être évitée.

Cette variable est un tableau qui contient les fonctions à appeler lorsque l'initialisation de MediaWiki est quasiment terminée. Les extensions peuvent enregistrer les fonctions de rappel à exécuter de cette manière, en utilisant ExtensionFunctions de extension.json. Durant tout le temps où ces fonctions de rappel sont appelées, MediaWikiServices et le RequestContext principal sont entièrement initalisés.

Notez aussi que les variables de configuration ont déjà été prises en compte à ce point et vouloir les modifier est dangereux. Les extensions devant initialiser la configuration dynamiquement utilisent à la place une fonction de rappel d'enregistrement.

Les fonctions de rappel de ExtensionFunction doivent être utilisées uniquement pour du code d'initialisation devant interagir avec les objets de service en tant qu'étape finale.

Par exemple, si votre extension a besoin d'accéder à la base de données pendant son initialisation :

function initMyExtension() {
      $dbr = MediaWikiServices::getInstance()
            ->getConnectionProvider->getReplicaDatabase();
      $myExtension = new MyExtension();
      $myExtension->loadSettingsFromDatabase( $dbr );
}

Voir aussi