Manual:Upgrading/fr



Survol
Premièrement, lire le fichier UPGRADE inclut avec MediaWiki.

Comme avec toutes les mises à jour, vérifier les choses suivantes :


 * 1) Vérifier les prérequis
 * 2) Lire les notes de version
 * 3) Sauver les fichiers et la base de données
 * 4) Mettre en place les nouveaux fichiers
 * 5) Faire tourner le script de la mise à jour de la base données
 * 6) Mettre à jour les extensions
 * 7) Vérifier la mise à jour

Vérifier les prérequis
MediaWiki requiert :

PHP

 * PHP 5.0.x ou ultérieur
 * PHP 5.1.x ou 5.2.x. est recommandé
 * Note : PHP 5.0.x sous certaines plateformes 64-bit contient des bugs qui causent des erreurs majeures avec MediaWiki. Si vous êtes sous x86_64 (AMD64, EMT64) ou d'autres plateformes 64-bit touchées, PHP 5.1.x ou 5.2.x est requis.

SGBD

 * MySQL 4.0.x ou ultérieur
 * La version 3.x n'est plus supportée depuis MediaWiki 1.6.0

Ou


 * PostgreSQL 8.1 ou ultérieur
 * Les modules tsearch2 et plpgsql sont également requis

Lire les notes de version
Dans le fichier compressé qui contient MediaWiki, ou les fichiers exportés depuis SVN, il y a un certain nombre de fichier nommés avec des lettres capitales, un de ceux-là contient les RELEASE-NOTES (ou notes de version, en anglais). Il faut les ouvrir et les lire pour voir ce qui a été changé dans la version. Vous pouvez aussi les lire sur Release notes/.

Sauver les fichiers et la base de données
Bien que le script de mise à jour soit à jour et robuste, il peut toutefois y avoir des ratés. Avant de procéder à la mise à jour du schéma de la base de données, il faut faire une sauvegarde complète du wiki, incluant la base de données ainsi que les fichiers suivants :


 * le contenu du wiki, de la base de données. Ce peut aussi être une bonne idée de créer un fichier XML en plus du fichier SQL.
 * les images et les autres media (le contenu du dossier images)
 * les fichiers de configuration, i.e. LocalSettings.php et AdminSettings.php (si présent)
 * les fichiers de MediaWiki, incluant toutes les apparences et les extensions, fortement recommandé si elles ont été modifiées

Voir Manual:Backing up a wiki (en anglais) pour les instructions.

Mettre en place les nouveaux fichiers
Si vous utilisez un fichier compressé, décompressez-le; si vous utilisez Subversion, exportez les fichier dans un nouveau dossier. Remplacez les fichiers existant par les nouveaux de la version, en conservant la structure du répertoire. Le code de MediaWiki est maintenant à jour.

Faire tourner le script de la mise à jour de la base de données
Note : Il faut être sur qu'il existe un fichier AdminSettings.php dans le répertoire principal du wiki, et qu'il contient les informations correctes. L'utilisateur inscrit dans ce fichier doit avoir les permissions complètes sur la base de données.

La meilleure méthode est de faire tourner le script de mise à jour bien qu'il soit possible de réutiliser l'installeur.

Shell
Depuis un invite de ligne de commandes, ou un shell SSH ou similaire, changer le répertoire courant pour être dans le dossier maintenance et exécuter le script suivant :

$ php update.php

Il est parfois nécessaire de préciser l'emplacement du fichier AdminSettings.php ou AdminSettings.sample (ça fonctionne avec les 2). Lorsque vous êtes dans le dossier maintenance</tt> vos pouvez exécuter le script suivant :

$ php update.php --aconf ../AdminSettings.php

(ou bien en remplaçant AdminSettings.php par AdminSettings.sample si vous ne l'avez pas renommé)

MediaWiki va inspecter le schéma de la base de données, et le mettre à jour pour qu'il puisse être utilisable avec le nouveau code de MediaWiki, en ajoutant des tables et des colonnes si nécessaire.

Alternative 1 : phpShell
Si l'accès au shell n'est pas disponible, considérer des alternatives tel que phpShell, qui émule une ligne de commandes en utilisant les fonctions PHP. Il est possible que celui-ci ne fonctionne pas chez certains hébergeurs, selon la configuration du serveur web.

Lorsqu'un tel système est utilisé, il pourrait être désirable de sauter le compte à rebours au début du script. Pour ce faire, il faut passer l'option --quick</tt> au script de la manière suivante :

$ php update.php --quick

S'il y a différentes versions de PHP installées sur le système, il est possible d'avoir besoin d'utiliser "php5" à la place de "php". Avec phpShell, il sera peut-être nécessaire de modifier les fichiers commandLine.inc et LocalSettings.php afin d'éviter que le script se termine à cause du fait que phpShell s'exécute d'après le serveur web.

Alternative 2 : Refaire tourner l'installeur
Une alternative consiste à refaire tourner l'installeur utilisé pour l'installation du Wiki. Pour faire ceci, il faut :


 * 1) Renommer LocalSettings.php</tt> en LocalSettings.old.php</tt>
 * 2) Faire en sorte que le dossier config</tt> soit accessible en écriture par le serveur web
 * 3) Être sûr que l'utilisateur de la base de données ait un accès complet à celle-ci
 * 4) Aller au wiki via un navigateur web et répéter l'installation

Remplir les cases avec les mêmes valeurs que lors de la première installation. Lors de l'exécution, le script va détecter les tables existantes et les mettre à jour. Quand ceci sera fini, un nouveau fichier LocalSettings.php</tt> va être généré.


 * 1) Supprimer ce nouveau fichier
 * 2) Renommer LocalSettings.old.php</tt> en LocalSettings.php</tt>
 * 3) Restaurer les permissions du dossier config</tt>.

Mettre à jour les extensions
Certaines extensions ont été mises à jour pour fonctionner avec MediaWiki. Il faut être sûr de mettre à jour la dernière version de ces extensions. Il peut être nécessaire de faire des mises à jour manuelles avec certaines extensions personnalisées.

Vérifier la mise à jour
Une fois la mise à jour terminée, vérifier que tout fonctionne comme voir et éditer des pages pour être sûr que tout marche comme prévu.

Voir la page Special:Version et vérifier que la version affichée est correcte.