Manuel:Update.php
| fichier de MediaWiki : update.php | |
|---|---|
| Emplacement : | maintenance/ |
| Code source : | master • 1.35.1 • 1.31.12 |
| 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 signalent dans leur documentation.
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.
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 ! |
$ 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.
--wiki wikiId- mettre à jour la famille de wiki si le nom de la base de données dépend de l'hôte virtuel, où wikiId est le nom de la base de données (par exemple enwiki, dewiki ...)
Paramètres spécifiques au script
--quick- Sauter la séquence de compte à rebours
--nopurge- Ne pas purger la table objectcache. Normalement
update.phppurge le cache objectcache (contient généralement le cache du parseur et le cache des messages), les tables msg_resource et msg_resource_links (ceux-ci sont utilisés pour la mise en cache des messages de ResourceLoader et sont effacés en version 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 les 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 les familles de wikis.
--noschema- Toutes les modifications faites sur la structure de la table ou les ajouts apportés sont ignorés. Seules les modifications des données sont réalisées.
--schema- Aucune modification du schéma n'est appliquée à la base de données, mais les modifications du schéma sont enregistrées dans un fichier SQL séparé qui peut être exécuté.
false. Ceci est utile pour les environnements non-WMF où les autorisations strictes d'accès à la base de données permettent des mises à jour de celle-ci (réalisées par update.php), mais pas les modifications du schéma (telles que l'ajout ou la suppression de tables ou d'indexes que update.php réalise aussi).--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 uniquement. |
Les extensions peuvent installer/mettre à jour leurs schémas à l'aide de l'accroche LoadExtensionSchemaUpdates .
Voir aussi
- Manuel:$wgDBadminuser et Manuel:$wgDBadminpassword
- Pour des instructions détaillées sur l'utilisation de
update.php, voir Mise à jour, Manual:Upgrading#Command_line