Jump to content

Manuel:UpdateCollation.php

From mediawiki.org
This page is a translated version of the page Manual:UpdateCollation.php and the translation is 37% complete.
Version de MediaWiki :
1.19

Details

Ce script met à jour les collations des catégories. Vous devez exécuter ce script dès que $wgCategoryCollation a été modifié. Il faut également l'exécuter après avoir fait la mise à jour vers la version 1.17, et après une version de MediaWiki précédent la 1.17. Habituellement il est exécuté comme partie de update.php.

Si vos collations de catégories sont mélangées (avec des éléments triés anormalement dans les catégories), vous pouvez utiliser l'option --force pour forcer l'initialisation de toutes les collations de catégories.

La version exécutable du script dépend du nombre de rangées dans categorylinks , et pour les très gros wikis peut prendre jusqu'à 24 heures. (Une exécution sur la Wikipedia anglophone en septembre 2016 a pris environ une semaine : phab:T136150.) Le script peut traiter de l'ordre de 10.000 rangées par minute (en fonction de votre configuration); vous pouvez voir le nombre estimé de rangées sur votre wiki avant de lancer le script réellement, en tapant updateCollation.php --dry-run. Des wikis Wikimedia de différentes tailles ont été utilisés sans peine pour changer à plusieurs reprises les collations dans le temps (phab:T47443), simplement assurez-vous d'avoir estimé le temps que mettra le script à s'exécuter, avant de démarrer.

Options/Arguments

Option Description Required?
--force Run on all rows, even if the collation is supposed to be up-to-date. optionnel
--previous-collation Set the previous value of $wgCategoryCollation here to speed up this script, especially if your categorylinks table is large. This will only update rows with that collation, though, so it may miss out-of-date rows with a different, even older collation. optionnel
--target-collation Set this to the new collation type to use instead of $wgCategoryCollation. Usually you should not use this, you should just update $wgCategoryCollation in LocalSettings.php . optionnel
--target-table Copy rows from categorylinks into the specified table instead of updating them in place. optionnel
--remote Use Shellbox to calculate the new sort keys remotely. optionnel
--dry-run Don't actually change the collations, just compile statistics. optionnel
--verbose-stats Show more statistics. optionnel

Usage

php maintenance/updateCollation.php [ --force| --previous-collation| --target-collation| --target-table| --remote| --dry-run| --verbose-stats ]

Dry run to check updates

Terminal

Updating category collations

Terminal

Voir aussi