Manuel:UpdateCollation.php

This page is a translated version of the page Manual:UpdateCollation.php and the translation is 28% complete.
Outdated translations are marked like this.
Version de MediaWiki :
1.19


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
$ $ php maintenance/updateCollation.php --dry-run

Selecting next 100 rows... processing...0 rows would be updated so far.
Selecting next 100 rows... processing...0 rows would be updated so far.

Updating category collations

Terminal
$ php maintenance/updateCollation.php

Selecting next 100 rows... processing...100 done.
Selecting next 100 rows... processing...143 done.
143 rows processed

Voir aussi