Manual:Upgrading to 1.8/fr
Cette page contient des information pour une mise à jour vers une ancienne version de MediaWiki. Il vous est recommandé de faire une mise à jour vers 1.42.3 si possible. Des instructions en ce sens sont disponibles sur la page Mise à jour . |
Version stable (MediaWiki 1.42 )
- mediawiki-1.42.3.tar.gz
- mediawiki-1.42.3.zip
- Branche Git: REL1_42
Anciennes versions (MediaWiki 1.41 )
- mediawiki-1.41.4.tar.gz
- mediawiki-1.41.4.zip
- Branche Git : REL1_41
Version Alpha (MediaWiki 1.44 )
Autres informations :
Les développeurs de MediaWiki sont des abeilles affairées :-) MediaWiki 1.8 est disponible et apporte de nouvelles fonctionnalités sympas, chouette ! Et vous faites toujours tourner une ancienne version ? Alors comment commencer la mise à jour ?
Ce guide devrait aider les utilisateurs de la version 1.7 à migrer vers MediaWiki 1.8 en douceur. Il marchera aussi pour les utilisateurs de la branche obsolète 1.6.
Présentation
editTout d'abord, lisez le fichier texte de mise à jour inclus dans MediaWiki 1.8.
Comme avec toutes les mises à jour MediaWiki, les prémisses de base sont les mêmes :
- Vérifier les exigences
- Lire les notes de version
- Sauvegarder les fichiers existants et la base de donnée
- Déballer les nouveaux fichiers
- Lancer le script de mise à jour pour vérifier la base de donnée
- Mettre à niveau les extensions
- Tester la mise à jour
Vérifier les exigences
editMediaWiki 1.8 a besoin de :
- PHP 5.0 ou plus (5.1 recommandé)
- PHP 4 n'est plus supporté depuis 1.7
- MySQL 4.0 ou plus
- MySQL 3.x n'est plus supporté depuis 1.6
Lire les notes de version (RELEASE-NOTES)
editDans le tarball de la distribution, ou dans les fichiers en check out ou exportés de SVN, il y a un certain nombre de fichiers dont le nom est en majuscule, dont un fichier RELEASE-NOTES. Il est temps de l'ouvrir et de regarder ce qui a changé en 1.8.
Sauvegarder les fichiers existants et la base de donnée
editTant que les scripts de mise à jours sont correctement maintenus et robustes, les choses pourraient se barrer en sucette. Avant de procéder à la mise à jour du schéma de base de donnée, faire une sauvegarde complète du wiki, en incluant la base de donnée et les fichiers.
La base de donnée
editFaire une sauvegarde complète de la base de données wiki avant de s'essayer à lancer les scripts de mise à jour dessus. Ceci sert de précaution de base si la mise à jour du schéma échoue, laissant les enregistrements dans un état défectueux ou corrompu. Il y a un certain nombre d'utilitaires pour faire cela, tel que MySQL dump, qui est fourni avec le software MySQL.
Paramètres
editFaire une copie de votre fichier LocalSettings.php
, qui contient les détails de configuration de base et les personnalisations que vous pouvez avoir apporté au comportement de MediaWiki.
Fichiers copiés sur le serveur
editSi les upload sont activés sur le wiki, vous aurez aussi besoin de sauvegarder le répertoire de téléchargement. Par défaut, c'est le répertoire images
, bien que le chemin vers celui-ci ait pu être changé dans LocalSettings.php
.
Extensions et apparences personnalisées (skin)
editPrendre une copies du répertoire extensions
, et de tout fichier ou répertoire contenant une personnalisation d'apparence (skin).
Déballer les nouveaux fichiers
editSi vous utilisez un paquetage tarball téléchargé sur SourceForge, le décompresser ; exporter les fichiers dans un endroit clean. Remplacer tous les fichiers existants avec ceux de la version 1.8, en conservant la structure des répertoires. Le code du noyau est maintenant à jour.
Lancer le script de mise à jour
editNote: S'assurer qu'il y a un fichier AdminSettings.php
à la racine du wiki, et que les informations qu'il contient sont à jour. L'utilisateur a besoin de tous les droits sur la base de données.
La méthode conseillée pour réaliser la mise à jour est d'utiliser le script de mise à jour en ligne de commande, cependant, il est aussi possible de relancer l'installeur web.
Shell
editDepuis la ligne de commande, un shell SSH ou autre, entrer dans le répertoire maintenance
et exécuter le script de mise à jour :
$ php update.php
MediaWiki inspectera le schéma existant et le mettra à jour de manière à fonctionner avec le nouveau code. En cas de mise à jour à partir d'une 1.5.x, une fois terminée, il est conseillé de lancer le script refreshLinks.php
pour mettre à jour la table des liens.
Alternative : phpShell
editSi l'accès au shell n'est pas disponible, envisager des options telles que phpShell, qui émule une invite de commande en utilisant des fonctions PHP. Ceci peut ne pas fonctionner sur certaines installations d'hébergement verrouillées.
En utilisant une solution pareille, il est souvent préférable de sauter le compte à rebours au début du script.
Passer l'option --quick
au script de mise à jour de cette manière :
$ php update.php --quick
Relancer l'installeur
editUne alternative au lancement du script de mise à jour à partir du shell est de relancer l'installeur web. Pour cela :
- Renommer
LocalSettings.php
enLocalSettings.php.old
- Rendre le répertoire
config
modifiable par le serveur web - Parcourir le wiki et démarrer l'installeur
Remplir les champs du formulaire avec les mêmes valeurs que lors de l'installation de la version précédente.
Quand la procédure d'installation commence, le script détecte les tables MediaWiki existantes, et mettre à jour leur schéma. Quand c'est terminé, un nouveau fichier LocalSettings.php
est généré.
- Supprimer le nouveau fichier de configuration
- Renommer
LocalSettings.php.old
versLocalSettings.php
- Restaurer les droits sur le répertoire
config
Mettre à niveau les extensions
editCertaines extensions ont été mise à jour dans le but de fonctionner avec MediaWiki 1.8. S'assurer de faire une mise à niveau des dernières versions de telles extensions. Vous pouvez avoir besoin d'effectuer des mises à jour manuelles pour personnaliser les extensions.
Tester la mise à jour
editUne fois la mise à jour terminée, parcourir le wiki et faire des vérifications de base comme afficher ou modifier des pages pour s'assurer que les choses fonctionnent comme on pouvait s'y attendre.
Aller sur la page Special:Version et vérifier que la version affichée est correcte.