Manuel:Update.php

fichier de MediaWiki :Manual:Code update.php
Emplacement :	maintenance/
Code source :	master • 1.31.1 • 1.30.1
Classes :	UpdateMediaWiki

Détails

update.php vérifie si le schéma de la base de MediaWiki doit être mis à jour afin de travailler avec la version actuelle de MediaWiki. Vous devez exécuter update.php après chaque mise à niveau de MediaWiki ou après la mise à jour ou l'installation d'une extension qui nécessite une mise à jour du schéma. La plupart des extensions qui nécessitent des mises à jour de schéma le signale dans leur documentation.

Depuis le navigateur

Si vous n'avez pas accès à la ligne de commande de votre serveur, utilisez la mise à jour Web pour exécuter le script de mise à jour.

→ Mise à jour Web

Depuis la ligne de commande

Depuis la ligne de commande, un shell SSH ou similaire :

• Choisir le répertoire maintenance
• Exécuter le script de mise à jour :

$ php update.php

Avertissement :

update.php peut sortir avec des erreurs, laissant la base de données dans un état incohérent. Toujours sauvegarder la base de données avant d'exécuter le script !

Ce script de maintenance peut être désactivé via $wgAllowSchemaUpdatesManual:$wgAllowSchemaUpdates (dans 1.18.0 par $wgMiserModeManual:$wgMiserMode). Les personnes avec des wikis extrêmement grands et occupés peuvent avoir besoin de faire des mises à jour avec soin, mais si vous n'êtes pas sûr si cela s'applique à vous, alors ne le faites probablement pas.

Utilisez les instances suivantes sur VagrantMediaWiki-Vagrant (à partir de votre ssh vagrant ).

$ mwscript update.php

Paramètres

Ce script offre plusieurs paramètres (génériques, script dépendants et spécifiques au script) qui peuvent être nécessaires dans certains environnements wiki.

Paramètres génériques de maintenance

--help

Utilisé pour obtenir une invite de tous les paramètres de script disponibles (générique, script dépendant et script spécifique) avec des explications courtes de leur utilisation. Ce sont des paramètres moins souvent utilisés.

Paramètres spécifiques au script

--quick

Sauter la séquence de compte à rebours

--nopurge

Ne pas purger la table objectcache. Normalement update.php purge le cache objectcache (contient généralement le cache du parseur et le cache des messages), msg_resource et msg_resource_links (Ceux-ci sont utilisés pour la mise en cache des messages de ResourceLoaderResourceLoader et sont effacés dans 1.21 et ultérieures) dans la base de données, si vous ne voulez pas purger cette table, utilisez l'option --nopurge.

--doshared

Mettre à jour tables partagées aussi.

--force

Exécutez ce script même s'il est désactivé par les options de configuration.

--conf

Spécifie le fichier de configuration (le fichier LocalSettings.php du wiki spécifique). Utilisé pour familles wiki.

--skip-compat-checks

Ignore les contrôles de compatibilité

--skip-external-dependencies

when using composer.local.json to let Composer install extensions and their dependencies, you may see an error message saying that there is a mismatch between the installed and required version (e.g. "mediawiki/semantic-breadcrumb-links: 1.3.0 installed, ~1.3 required"). You can use this parameter to ignore the message and run update.php regardless.

Avertissement :

Recommandé pour les développeurs.

Les extensions peuvent installer/mettre à jour leurs schémas à l'aide de LoadExtensionSchemaUpdatesManual:Hooks/LoadExtensionSchemaUpdates hook.

Voir aussi

• Manuel:$wgDBadminuserManual:$wgDBadminuser et Manuel:$wgDBadminpasswordManual:$wgDBadminpassword
• Pour des instructions détaillées sur l'utilisation de update.php, voir Manuel:Mise à jourManual:Upgrading, Manual:Upgrading#Command_line