Manual:UpdateCollation.php/fr
| Version de MediaWiki : | ≥ 1.19 |
| Fichier MediaWiki : updateCollation.php | |
|---|---|
| Emplacement : | maintenance/ |
| Code source : | master • 1.43.1 • 1.42.6 • 1.39.12 |
| Classes : | UpdateCollation |
Détails
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 et arguments
| Option | Description | Nécessaire ? |
|---|---|---|
| --force | Exécuter sur chaque ligne même si la collation est sensée être à jour. | optionnel |
| --previous-collation | Initialiser la valeur précédente de $wgCategoryCollation ici pour accélérer ce script, surtout si votre table de categorylinks est grande. Cela ne fera que mettre à jour les lignes avec cette collation, cependant, de sorte qu'il peut ignorer les lignes obsolètes avec une collation différente, ou encore plus ancienne. | optionnel |
| --target-collation | A initialiser avec le nouvaeu type de collation à utiliser au lieu de $wgCategoryCollation. Habituellement vous ne devez pas utiliser cela, vous devez juste mettre à jour $wgCategoryCollation dans LocalSettings.php. | optionnel |
| --target-table | Copiez les lignes des liens de catégorie dans la table indiquée au lieu de modifier ceux qui existent déjà. | optionnel |
| --remote | Utilisez Shellbox pour calculer les nouvelles clés de tri à distance. | optionnel |
| --dry-run | Ne modifiez pas les collations actuelles, compilez simplement les statistiques. | optionnel |
| --verbose-stats | Afficher d'autres statistiques. | optionnel |
Utilisation
php maintenance/run.php updateCollation [ --force| --previous-collation| --target-collation| --target-table| --remote| --dry-run| --verbose-stats ]
php maintenance/scriptName.php au lieu de php maintenance/run.php scriptName.
Exécuter à vide pour vérifier les mises à jour
$ php maintenance/run.php updateCollation --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.
Mise à jour des collations de catégories
$ php maintenance/run.php updateCollation Selecting next 100 rows... processing...100 done. Selecting next 100 rows... processing...143 done. 143 rows processed
Voir aussi
- Categorylinks table
- Manual:Hooks/GetDefaultSortkey
- Manual:Hooks/Collation::factory
- $wgCategoryCollation