Manuel:UpdateCollation.php
| Version de MediaWiki : | ≥ 1.19 |
| Fichier MediaWiki : updateCollation.php | |
|---|---|
| Emplacement : | maintenance/ |
| Code source : | master • 1.42.3 • 1.41.4 • 1.39.10 |
| Classes : | UpdateCollation |
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
$ 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
$ php maintenance/updateCollation.php Selecting next 100 rows... processing...100 done. Selecting next 100 rows... processing...143 done. 143 rows processed