Manual:Upgrading/fr



Présentation générale


Transfert de fichiers
Choisissez une méthode pour transférer les fichiers :


 * wget
 * Copie sécurisée avec SCP ou WinSCP
 * Protocole de transfert de fichiers SSH (SFTP)
 * Utiliser un client FTP.
 * Votre hébergeur peut mettre à disposition un gestionnaire de fichiers en ligne, vérifiez auprès de votre hébergeur.
 * Une autre méthode. Voir List of file transfer protocols

Prérequis
Lisez.


 * 1) Vérifiez les prérequis
 * 2) Lire le fichier RELEASE-NOTES
 * 3) Lire le fichier UPGRADE
 * 4) Sauvegardez les fichiers existants et la base de données
 * 5) Décompressez les nouveaux fichiers
 * 6) Mettez à jour les extensions
 * 7) Exécutez le script de mise à jour pour vérifier la base de données
 * 8) Testez la mise à jour
 * 9) Supprimer ce qui reste des anciennes installations



Vérifier les paramètres nécessaires
MediaWiki nécessite :


 * PHP +
 * L'une des options suivantes :
 * MariaDB +
 * MySQL +
 * PostgreSQL +
 * SQLite +

Depuis la version 1.36, MediaWiki ne valide que la prise en charge des mises à jour des deux dernières versions LTS (voir T259771). Les mises à jour à partir de versions plus anciennes de MediaWiki devront se faire en plusieurs étapes. Cela signifie que si vous voulez mettre à jour à partir de la 1.23 (ou plus ancienne) vers la 1.36, vous devrez d'abord faire la mise à jour de votre wiki 1.23 vers la 1.27 (ou 1.35), puis à partir de la 1.27 (ou la 1.35), vous pourrez faire la mise à jour vers la 1.36.

Si vous utilisez PostgreSQL, veuillez lire également.

Pour plus d'information, lisez et.



Lisez les notes de version
Dans l'archive de l'installation ou dans les fichiers copiés/exportés de Git sont présents des fichiers nommés en majuscules dont l'un contient les notes de version  (wiki). Il est maintenant temps de l'ouvrir et de rechercher ce qui a changé dans cette version. Lisez également les instructions dans le fichier UPGRADE.



Vider la file des tâches en attente d'exécution
Pour des raisons de performance, certaines actions sur la base de données sont retardées, et gérées par la file des travaux. Ces tâches sont rangées dans la base de données et contiennent des paramètres avec les informations indiquant les actions à réaliser. Il est vivement conseillé d'exécuter ces tâches en attente avant de faire la mise à jour du wiki, pour éviter qu'elles n'abortent dans le cas où la spécification des paramètres viendrait à changer d'une version à l'autre. Utilisez pour exécuter toutes les tâches en attente et vider la file d'attente avant de réaliser la mise à jour.



Sauvegarder les fichiers existants et la base de données

 * Instructions complètes : 

Même si les scripts de mise à jour sont maintenus et robustes, les choses peuvent mal tourner. Avant de procéder à la mise à jour du schéma de base de données, faites une sauvegarde complète du wiki, incluant à la fois la base de données et les fichiers :


 * le contenu du wiki, en commençant par la base de données (assurez-vous de spécifier correctement le jeu de caractères, vérifiez d'abord dans Localsettings.php). Il peut être utile de générer un export XML en plus de l'export SQL de la base de données.
 * MySQL, les deux exports SQL et XML sont à utiliser avec la commande  :

mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb > file.sql mysqldump --user=wikidb_user --password=wikidb_userpassword wikidb --xml > file.xml
 * PostgreSQL, un export de la base de données à utiliser avec la commande  :

pg_dump --create -Fc wikidb > file.db.dump
 * SQLite, utilisez un script MediaWiki pour créer la sauvegarde :

php wikifolder/maintenance/sqlite.php --backup-to file
 * les images et autres fichiers multimédia (le contenu du dossier, logo personnalisé /skins/common/images/wiki.png)
 * les fichiers de configuration, comme par exemple  et   (si présent)
 * les fichiers du programme MediaWiki, en incluant tous les habillages et les extensions en particulier si vous les avez modifiés.



Décompresser les nouveaux fichiers


Utiliser le paquet d'archive
Vous pouvez ramener les nouveaux fichiers en utilisant FTP ou la ligne de commande. Privilégiez la ligne de commande si vous y avez accès ! Celle-ci sera beaucoup plus rapide que de transférer les fichiers un à un parmi les milliers via FTP.



Client FTP ou interface graphique
Si vous ne pouvez pas utiliser le mode ligne sur votre serveur, téléchargez l'archive MediaWiki en local sur votre ordinateur et utilisez 7zip pour extraire l'archive sur votre PC local.

Une fois les fichiers extraits localement, utilisez le client FTP de votre choix pour téléverser les dossiers et fichiers sur le serveur.



Gestionnaire de fichiers cPanel
cPanel est une interface populaire fournie par plusieurs hébergeurs web. Cette méthode est efficace car les fichiers sont décompressés sur le serveur lui-même.


 * Allez dans le répertoire qui contient votre dossier wiki.
 * Téléverser le fichier mediawiki-1.xx.x.tar.gz. Vous devrez peut-être cliquer sur Recharger pour le voir.
 * Extraire le fichier mediawiki-1.xx.x.tar.gz. Recharger à nouveau.
 * Confirmer que le répertoire mediawiki-1.xx.x est présent.
 * Supprimer le fichier tar.gz.
 * Copiez dans le nouveau répertoire tous les habillages nécessaires, les extensions, les répertoires d'images, les personnalisations ainsi que LocalSettings.php. (voir ci-dessous).
 * Dès que vous êtes prêt à exécuter update.php, renommez l'ancien répertoire de votre wiki ainsi que le nouveau. (c'est à dire que 'w' devient 'w1.34' puis 'mediawiki1.35.0' devient 'w'.) Vous pouvez annuler cette étape facilement pour revenir en arrière si vous rencontrez des problèmes.



Ligne de commande
Il est possible que vous ayez à exécuter les commandes en tant que  si votre compte courant n'a pas toutes les permissions d'écriture dans le dossier d'installation du wiki. Lors de l'extraction de l'archive tarball de MediaWiki normalement un nouveau dossier va se créer pour la nouvelle version de MediaWiki et vous devrez y copier les anciens fichiers de configuration et le dossier 'images' depuis le dossier où se trouve l'ancienne installation :

Les utilisateurs d'(Open)Solaris doivent utiliser gtar ou :

$ gzip -dc mediawiki-.tar.gz | tar xf -



Autres fichiers
Après avoir extrait les archives, vous devez copier ou déplacer certains fichiers et dossiers depuis l'ancien répertoire d'installation vers le nouveau :
 * - contient vos anciens paramètres de configuration.
 * Le répertoire  (ou   dans des versions antérieures), qui contient tous les fichiers hébergés sur le wiki, sauf si vous avez spécifié un dossier différent pour le téléversement des fichiers. Vous devrez changer le propriétaire et les permissions de façon appropriée, par exemple avec   et   si l'utilisateur web est apache.
 * Certaines extensions du répertoire . Vous devriez toujours utiliser des versions actualisées des extensions ; il n'est pas garanti que les anciennes extensions fonctionnent avec une version plus récente de MediaWiki.
 * Si utilisez un logo personnalisé, ce fichier doit aussi être restauré à partir de la sauvegarde. Avant la version 1.24 il se trouve habituellement dans . À partir de la version 1.24 il se trouve dans le dossier   ou dans   si vous avez préféré l'utiliser. Dans ce cas ajoutez-le dans Localsettings.php, par exemple avec
 * Pour la 1.35 vous devrez peut-être restaurer les logos depuis . Ensuite ajoutez à LocalSettings.php par exemple
 * Les habillages personnalisés au sein du répertoire.
 * Toutes modifications réalisées sur les anciens fichiers d'installation ou aux extensions.
 * Les éventuels fichiers .htaccess (si vous utlisez Apache et que vous y avez défini des règles).

Une fois fait ceci, faites de ce nouveau dossier le dossier publié sur le serveur, ou renommez l'ancien dossier d'installation, et ensuite renommez le nouveau dossier pour qu'il coïncide avec l'ancien nom. Modifiez le propriétaire et le groupe de chaque élément pour que le serveur web puisse accéder aux fichiers.



En utilisant Git
Si vous utilisez, exportez les fichiers dans un dossier vide et ensuite copiez uniquement les fichiers modifiés dans le nouveau répertoire comme détaillé dans la section précédente.

Vous devrez aussi installer certaines bibliothèques PHP externes en utilisant Composer ou une archive fournie maintenue pour la ferme de wikis Wikimedia. Plus de détails sur l'installation et l'actualisation des bibliothèques externes se trouvent dans la documentation de téléchargement Git.



Utilisation de patch
Un petit fichier de patch est habituellement disponible pour une mise à jour de version mineure. Vous devrez télécharger patch pour utiliser ceci. Téléchargez et extrayez manuellement le fichier patch depuis le site des archives ou bien suivez les instructions utilisant wget ci-dessous. Les patchs sont incrémentaux, vous ne pouvez pas ignorer une version.


 * 1) cd à votre répertoire principal MediaWiki (celui avec LocalSettings.php).
 * 2) Téléchargez le fichier de patch et faites un  gunzip dessus.
 * 3) Utilisez   pour vérifier ce qui sera changé (par exemple,  )
 * 4) Si tout va bien, lancez patch à nouveau sans.
 * 5) Vérifiez votre Special:Version et vous devriez voir le nouveau numéro de version en place.



Fichiers restants susceptibles de provoquer des erreurs
Si vous installez dans le même répertoire que l'ancienne version, il est possible que les anciens fichiers causent des problèmes avec la nouvelle version.

Si vous n'utilisez pas profiling, mais que vous avez un fichier  dans le répertoire racine de MediaWiki, vous pouvez voir apparaître des erreurs de référence à. En effaçant ou renommant le fichier , vous corrigerez cette erreur. Le fichier , qui est aussi dans le répertoire racine de MediaWiki, peut servir de modèle au cas où vous activeriez le profiling à l'avenir.

MediaWiki 1.23 abandonne le mécanisme de découverte automatique des fichiers d'habillage embarqués. Après la mise à jour vers cette version, vous devez vérifier directement que les anciens fichiers,  ,   et   dans le répertoire   de même que les sous-répertoires correspondants dans  , ont été supprimés. MédiaWiki enregistrera les avertissements si certains d'entre-eux sont encore présents, pour vous aider à vous en souvenir (vous aurez aussi besoin d'ajuster les habillages personnalisés pour suivre une convention similaire). Voir pour les détails.

MediaWiki 1.24 modifie les chemins des fichiers d'habillage système. Après avoir fait la mise à jour vers cette version, vous devez vérifier directement que les anciens fichiers,  ,   et   du répertoire   , ne sont plus présents. Voir pour les détails.



Mettre à jour les extensions
Certaines extensions ont été mises à jour pour fonctionner avec la nouvelle version de MediaWiki. Vérifiez de que vous utilisez bien la dernière version de ces extensions. Il est possible que vous ayez à faire les mises à jour manuellement pour les extensions personnalisées.

Les différentes archives de distribution .tar contiennent quelques sous-ensembles des extensions ainsi qu'un numéro de version pour vous aider à mettre à jour en choisissant celui compatible avec la version de votre coeur de système MédiaWiki.

L'extension Distributor fonctionne bien pour la plupart des personnes qui veulent une capture des extensions compatible avec les versions que leur MédiaWiki peut supporter.

Si vous désirez beaucoup d'extensions alors le téléchargement à partir de Git est probablement la meilleure chose. Si vous ne possédez pas Git et voulez mettre à jour un grand nombre d'extensions, vous pouvez utiliser mwExtUpgrader.

<span id="Adapt_your_LocalSettings.php">

Adaptez votre LocalSettings.php
Si vous utilisez le  de l'ancienne version, il est possible que vous deviez l'adapter en fonction de l'utilisation qu'en fait la nouvelle version :

<span id="Skin_registration">

Enregistrement de l'habillage
Depuis MediaWiki 1.24, les habillages embarqués tels que Vector, Monobook, Modern et CologneBlue ne font plus partie du coeur de MediaWiki, et ils doivent être enregistrés explicitement dans  pour pouvoir être utilisés, sinon MediaWiki vous avertira que vous n'avez pas installé ces habillages.

Voici ce que vous devez ajouter à  quand vous mettez à jour à partir d'une version plus ancienne que la 1.24 et que vous voulez mettre à disposition l'un des habillages suivants :

Les autres habillages peuvent encore ne pas avoir été adaptés au nouveau système d'enregistrement des habillages, aussi reportez-vous à la page de documentation de chacun d'eux pour voir comment l'enregistrer proprement en cas de problème.

<span id="Extension_registration">

Enregistrement des extensions
Depuis MediaWiki 1.25, les extensions utilisent un nouveau système d'enregistrement des extensions.

Auparavant votre  aurait inclus quelque chose comme :

Cela peut être converti en :

Nous sommes en train d'adapter les extensions pour utiliser le nouveau système d'enregistrement. Les extensions qui ne sont pas adaptées doivent utiliser l'ancienne méthode d'installation. Reportez-vous aux instructions d'installation sur la page des extensions pour plus d'information.

<span id="Remove_DefaultSettings.php_line_(if_necessary)">

Supprimer la ligne DefaultSettings.php (si nécessaire)
Les anciennes versions de MediaWiki généraient automatiquement une ligne dans LocalSettings.php appelant. Depuis la version 1.38, cette ligne est obsolète et ne fonctionne pas avec plusieurs extensions. Elle doit être supprimée.

Supprimer la ligne suivante :

<span id="Other_variables">

Autres variables
Certaines variables peuvent être obsolètes ou même avoir été retirées. Le fait de les avoir dans  n'a habituellement pas de conséquences. De nouvelles variables peuvent être ajoutées dans les versions les plus récentes, ou certaines variables peuvent voir leur type modifié. D'ordinaire, nous essayons d'utiliser pour elles, des valeurs saines par défaut, et dans le cas d'une modification de type, de conserver la compatibilité ascendante. Dans tous les cas, lisez les notes de livraison pour voir ces changements.

<span id="Run_the_update_script">

Exécuter le script de mise à jour
Vous pouvez mettre à jour la base de données MediaWiki de deux manières : soit à partir de la ligne de commande, soit à partir du navigateur web. Si vous avez accès au shell de votre serveur, la mise à jour à partir de la ligne de commande est recommandée, car cela réduit le risque que le processus de mise à jour soit interrompu par un dépassement de temps ou par la reinitialisation de la connexion.

Le script essayera aussi de télécharger toute dépendance manquante dont MediaWiki aurait besoin.

<span id="Command_line">

Ligne de commande
Allez à la ligne de commande sur votre serveur, ou par shell SSH ou équivalent. Vous pouvez accéder à la ligne de commande en vous connectant sur votre serveur par SSH. Si le PC local à partir duquel vous travaillez est sous Microsoft Windows, vous aurez besoin d'un outil tel que PuTTY pour utiliser SSH. A partir de la ligne de commande ou du shell, placez-vous dans le répertoire  et exécutez le script de mise à jour:

$ php update.php

Sur un serveur Linux, si vous obtenez une erreur, essayez d'exécuter la même commande en tant que root ( sudo php update.php ). Notez pour les installations simples sous Windows (par exemple avec ): D'abord s'assurer que votre serveur web (comme Apache) et que votre base de données (comme MySQL) sont montés (accessibles). Ensuite exécutez  : cliquez-droit dessus, sélectionnez « Ouvrir avec », et accédez à PHP.exe. La fenêtre de dialogue de la commande résultante se fermera vraisemblablement automatiquement quand la mise à jour du schéma sera terminée.

Vous pourriez voir un message indiquant que votre version de PHP est trop ancienne et que MediaWiki en réclame une version plus récente. Après ce message, la mise à jour s'arrête. Le motif de cette erreur est que la ligne de commande peut utiliser une autre version de PHP que celle que vous avez quand vous exécutez MediaWiki à partir du serveur web. Quand ce message apparaît, vérifiez si vous pouvez exécuter une nouvelle version de PHP dans le shell en utilisant une commande différente : ceci pourrait être par exemple php5 ou php56. La disponibilité d'une autre version et son nom (si elle est installée), dépendent de la configuration de votre serveur. Si cela ne fonctionne pas, demandez à votre hébergeur; il saura sûrement.

MediaWiki va scruter le schéma existant et le mettre à jour pour qu'il puisse travailler avec le nouveau code, en ajoutant des tables et des colonnes en fonction des besoins.

<span id="What_to_do_if_php_update.php_fails_to_do_anything,_resulting_in_a_quick_pause_and_then_return_to_command_prompt">

Que faire si le fichier php update.php échoue dans une action, résultant en un bref arrêt avant de retourner à l'invite de commande
Ceci peut être causé par une extension ou un habillage défaillant.


 * Vérifiez que toutes les extensions ainsi que tous les habilages appelés dans LocalSettings.php sont présents
 * Vérifiez que les extensions utilisent la méthode d'enregistrement correcte (wfLoadExtension avec require_once)
 * Commentez la première moitié des extensions en LocalSettings.php. Si cela fait fonctionner update.php, décommentez la moitié de cette moitié (donc 1/4 des extensions). Si cela ne fait PAS fonctionner update.php, décommentez la première moitié mais commentez la seconde moitié, puis commentez la moitié de la seconde moitié, etc. Recommencer jusqu'à ce que update.php fonctionne pour trouver celui qui échoue.

<span id="What_to_do_in_case_of_&quot;ALTER_command_denied_to_user&quot;_error_(or_similar)">

Que faire en cas d'erreur "ALTER command denied to user" (ou similaire)
Dans le cas où le script échoue avec un message similaire à :

Error: 1142 ALTER command denied to user 'wiki'@'localhost' for table 'mytable' (localhost) ERROR: must be the owner of the mytable relation

Cela signifie que vous devez vérifier d'avoir bien défini et  dans votre fichier  (dans le répertoire principal). C'est l'utilisateur et le mot de passe nécessaire au script pour accéder à la base de données.

Dans certains cas, une ancienne variable $wgDBmwschema (pour Postgres) semble être lue pour le nom de la table au lieu de $wgDBname, même quand MySQL est utilisé. Dans ce cas, supprimez simplement la définition de $wgDBmwschema dans LocalSettings.php.

<span id="What_to_do_in_case_of_&quot;unexpected_T_STRING&quot;_error">

Que faire en cas d'erreur "unexpected T_STRING"
Les utilisateurs qui exécutent update.php individuellement à partir de leur ligne de commande peuvent rencontrer l'erreur suivante :

<pre style="overflow:auto;"> syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or '}' \ in ~/maintenance/commandLine.inc on line 13

Cette erreur apparait quand vous exécutez update.php sous php4.

Les personnes qui ont leur site hébergé chez des fournisseurs qui mettent à disposition à la fois php4 et php5, doivent suivre les étapes suivantes :


 * 1) sur la ligne de commande, entrez 'whereis php5'
 * 2) dès que vous avez identifié le chemin vers php5, affichez le contennu du répertoire php5/bin
 * 3) une fois le nom de l'exécutable php trouvé (php ou php5), entrez le chemin complet pour exécuter update.php

Voici un exemple :

<pre style="overflow:auto;"> $ command -v php5 $ ls -la /usr/local/php5/bin $ /usr/local/php5/bin/php update.php

<span id="What_to_do_in_case_of_&#039;register_argc_argv_is_set_to_false&#039;_error">

Que faire en cas d'erreur 'register_argc_argv is set to false'
Vous pouvez rencontrer cette erreur : <pre style="overflow:auto;"> Cannot get command line arguments, register_argc_argv is set to false


 * 1) Allez dans ~/maintenance. Modifiez un fichier 'php.ini' existant, ou créez-en un.
 * 2) Ajoutez une ligne comme ceci :

<pre style="overflow:auto;"> register_argc_argv=true


 * 1) Réexécutez

<span id="Web_browser">

Navigateur web

 * Voir aussi 

Si votre base de données est déja imposante et utilisée à un haut niveau, alors il ne faut pas utiliser la mise à jour par le web, par exemple parceque le processus de mise à jour vas échouer faute de temps suffisant quand le maximum_execution_time sera atteint. Dans ce cas vous devez utiliser update.php à partir de l'interface ligne de commande (pas à partir du web). Que signifie exactement "imposante", cela dépend de votre serveur (par exemple de ses performances, de la charge et du temps maximal d'exécution que PHP attribue à l'exécution du script). Si votre wiki est trop gros pour la mise à jour par web et que votre fournisseur d'hébergement n'autorise pas l'accès aux commandes en mode ligne, alors vous devez migrer votre wiki vers un autre compte d'hébergement possédant - lui - un accès réel au shell.


 * 1) Faites toujours une copie de sauvegarde (back up) avant la maintenance de la base de données.
 * 2) Allez sur   dans votre navigateur Web. Par exemple, si votre wiki est à , alors naviguez jusqu'à.
 * 3) Choisissez votre langue et cliquez sur continuer.
 * 4) L'installation existante devrait être détectée. Suivez les instructions à l'écran pour en faire la mise à jour. Si la "clé de mise à jour" est demandée, ouvrez votre fichier  et cherchez la valeur assignée à.

Il peut arriver que la mise à jour par web semble ne pas fonctionner : au lieu de voir le menu initial de l'écran de sélection de langue, vous pouvez obtenir une page wiki vide, avec éventuellement des messages d'erreur. Dans ce cas il est probable que votre serveur web utilise les règles de réécriture (- Rewrite Rules - probablment pour les URLs courtes), qui ne vous montrent pas le moteur de mise à jour dans mw-config/, mais sur une page wiki à Mw-config/, avec un "M" majuscule. Dans ce cas, renommez le fichier .htaccess pour le temps de la mise à jour. Vous devriez ensuite pouvoir accéder à la mise à jour par web.

<span id="Test_the_update">

Tester la mise à jour
Une fois que la mise à jour s'est terminée, explorez le wiki et vérifiez que les opérations suivantes s'exécutent comme désiré :


 * afficher des pages
 * modifier des pages
 * téléverser un fichier
 * consultez Special:Version et vérifiez que la version affichée est correcte et que les extensions sont présentes.

<span id="Remove_leftovers_from_old_installations">

Supprimer ce qui reste des anciennes installations
Si vous avez recopié votre ancienne installation dans un autre répertoire du serveur, vérifiez que vous avez bien supprimé le dossier initial ou rendez le complètement inaccessible du web. Il est très important de ne pas laisser les anciennes installations accessibles à partir du web parce que cela nuit au principe de la mise à jour et laisse votre serveur ouvert aux attaques.

<span id="Frequently_asked_questions">

Foire aux questions
<section begin=FAQ />

<span id="How_hard_is_it_to_upgrade?">

Quelles sont les difficultés lors de la mise à jour ?
Si le seul fichier que vous avez modifié est, et que vous faites la mise à jour de la 1.5 ou ultérieure, le processus est très simple. La quantité de travail à fournir par un humain n'est que de quelques minutes. Les modifications du schéma de la base de données prendront un temps proportionnel à la taille de votre base de données — potentiellement des heures pour les wikis avec des millions de pages, mais pour des tailles plus typiques de quelques milliers de pages, cela prendra habituellement quelques secondes.

Les mises à jour mineures, à l'intérieur de la même version majeure, disons de la .0 vers la, ne nécessitent aucune modification du schema. Il vous suffit de mettre à jour les fichiers. La base de données n'a pas à être mise à jour, et donc il n'est pas nécessaire de lancer le script de mise à jour.

Faire la mise à jour de la 1.4 ou antérieure est potentiellement compliqué car la prise en charge des familles de caractères autres que UTF-8 a été sautée, et le schéma pour ranger du texte en masse a changé. Veuillez lire la section correspondante du fichier.

La mise à jour devient difficile si vous avez modifié notre code source, et que vous ne voulez pas que vos modifications soient écrasées. Les outils tels que diff, patch, Meld ou WinMerge peuvent vous être utiles. Il y a aussi des risques de perturbation si vous utilisez des extensions qui n'ont pas été maintenues. Mettez à jour vos extensions au même moment que vous mettez à jour MediaWiki.

Si vous avez modifié l'habillage, ou si vous utilisez un habillage personnalisé, vous devrez probablement l'ajuster pour le rendre compatible avec la nouvelle version de MédiaWiki.

<span id="How_do_I_upgrade_from_a_really_old_version?_In_one_step,_or_in_several_steps?">

Que faire si je mets à jour à partir d'une très ancienne version ? En une étape ou en plusieurs ?
Cela dépend : si vous effectuez une mise à niveau à partir de MediaWiki version 1.4 ou antérieure, vous devez d'abord effectuer la mise à niveau vers MediaWiki 1.5. Si vous faites la mise à jour à partir d'un wiki Latin-1, utilisez upgrade1_5.php (qui se trouve dans MediaWiki 1.5) pour convertir les parties concernées de la base de données en UTF-8 ( doit être mis à  dans votre  pour que cela fonctionne). Ensuite exécutez update.php, puis mettez l'option  de LocalSettings.php à la valeur de l'encodage que vous aviez précédemment pour le wiki (par exemple windows-1252). C'est principalement la manière dont Wikipedia et les autres sites de la Fondation Wikimedia ont été mis à jour pour le passage de MediaWiki 1.4 à 1.5 – voir la page de configuration pour enwiki et quelques notes associées sur Wikitech. Il est possible que vous ayez à passer en MediaWiki 1.4 avant d'exécuter le script upgrade1.5. Si vous voulez faire un vidage des tables de la base de données (par exemple MySQL) de votre wiki Latin-1, assurez-vous que le type du champ  de la table  vaut , et non pas   , pour éviter les problèmes d'encodage de caractères.

Si vous effectuez une mise à niveau à partir de MediaWiki 1.5 (ou plus récent) vers 1.35, vous pouvez faire la mise à niveau en une passe, de votre ancienne version vers la dernière version stable. La grande majorité des rapports, ainsi que des tests automatisés, indiquent que le faire en une seule étape fonctionne parfaitement. Si vous avez du mal à le croire, lisez cet article de la liste de diffusion. Cependant, veuillez noter que lorsque vous mettez à jour à partir d'anciennes versions, les chances de rencontrer des erreurs PHP sont plus grandes que lorsque vous effectuez une mise à jour à partir de la version qui précède la nouvelle version. Vous auriez de toute façon reçu ces erreurs si vous n'aviez pas sauté les versions, mais les erreurs auraient été associées à chaque mise à jour individuelle. En revanche, si vous passez plusieurs versions d'un coup, vous obtiendrez les mêmes erreurs toutes en même temps. Cela rendra la mise à jour plus difficile, mais n'oubliez pas que vous n'aurez pas de problème si vous mettez à jour les versions intermédiaires, que vous avez sautées!

Si vous faites la mise à jour vers MediaWiki 1.36 ou ultérieure, seules les mises à jour à partir des deux dernières versions LTS sont prises en charge (T259771). Cela signifie que pour les versions très anciennes, vous devrez d'abord passer en MediaWiki 1.35 puis en MediaWiki 1.36.

<span id="Should_I_back_up_first?">

Dois-je faire une sauvegarde préalable ?
Réponse courte : oui.

Réponse plus longue : cela dépend de a) la valeur que vous prêtez à vos données, b) la difficulté à créer une sauvegarde et c) l'expérience que vous avez en entretien et administration de MySQL.

Une faute dans la mise à jour peut laisser votre base de données dans un état instable, entre deux versions. Une erreur PHP ou MySQL pourrait survenir durant la mise à jour en laissant votre base de données partiellement traitée. Dans de telles situations il est possible qu'une personne puisse corriger ce problème avec beaucoup de travail manuel. Néanmoins, il serait plus facile de faire simplement une sauvegarde de la base de données juste avant de lancer update.php et de continuer avec. Sinon vous y passeriez - inutilement - toutes vos heures de travail.

La récupération est souvent complexe. Les bénévoles des forums de support ne se sentiront pas trop concernés si vous avez négligé de faire une sauvegarde et qu'ensuite vous avez besoin d'aide pour récupérer tout ce qui a été cassé par la mise à jour. Une meilleure solution est de réinstaller votre sauvegarde, puis de signaler le bogue sur le projet MediaWiki correspondant dans le processus de mise à jour qui a causé le dysfonctionnement.

<span id="Can_I_keep_my_LocalSettings.php?">

Puis-je conserver mon fichier LocalSettings.php ?
Oui, mais il se peut que vous deviez faire quelques petits changements. Le format de est fondamentalement compatible avec les versions précédentes. Les changements qui peuvent casser la compatibilité de LocalSettings.php seront documentés dans la section "Changements dans la configuration" des notes de version.

<span id="Can_my_wiki_stay_online_while_it_is_upgrading?">

Est-ce que mon wiki peut rester en ligne pendant la mise à jour ?
En général oui, néanmoins Git peut le casser temporairement (pendant quelques secondes).

Si vous mettez à jour entre des versions mineures de MediaWiki, il est uniquement nécessaire de mettre à jour les fichiers source.

Note : ce qui suit suppose que vous avez accès à la ligne de commande. Si vous êtes en train de mettre à jour entre des versions majeures de MediaWiki, la procédure recommandée est la suivante :

$adminTask = ( ===  ||  ); = $adminTask ? : ;
 * 1) Décompressez la nouvelle version de MediaWiki dans un nouveau dossier
 * 2) Préparez ce nouveau dossier : copiez votre LocalSettings.php actuel de l'ancien répertoire, ainsi que les extensions et les habillages personnalisés que vous pouvez avoir installés (s'il y en a). Vérifiez les paramètres  et  dans LocalSettings.php et, si nécessaire, copiez le fichier logo de l'ancien répertoire vers le nouveau répertoire.
 * 3) Dans les notes de version pour la nouvelle version, vérifiez s'il faut faire des modifications dans LocalSettings.php.
 * 4) Dans l'ancien répertoire, modifiez LocalSettings.php en insérant le code suivant : Ceci va mettre la base de données en mode lecture seule pour les activités régulières du wiki sans restreindre vos propres actions de mise à jour. Les utilisateurs verront le message fourni s'ils essaient de modifier pendant le processus de mise à jour.
 * 1) Exécutez le script de mise à jour ou via l'interface web dans le nouveau dossier.
 * 2) Copiez les images du sous-dossier d'images de l'ancien répertoire vers le nouveau.
 * 3) Permutez l'ancien répertoire avec le nouveau. (Cela va rendre la base de données de nouveau accessible en écriture, car  n'était positionné que dans LocalSettings.php de l'ancien répertoire).

<span id="Why_upgrade?">

Pourquoi mettre à jour ?

 * Abonnez-vous à la liste mediawiki-announce pour être notifié des nouvelles versions.

Parce que c'est habituellement assez facile, une seule étape de votre version à la dernière et aussi via le web.

Les versions récentes reçoivent des correctifs de sécurité pour protéger votre wiki et votre hôte des vandales, ce qui n'est pas le cas des anciennes versions (voir ). Ce qui vous donne des dizaines de bonnes raisons pour faire la mise à jour!

Les nouvelles versions majeures sont livrées avec de nouvelles fonctions que vous pourriez utiliser: voir la bulletin de livraison pour les détails. Dans le cas où vous auriez besoin de détails supplémentaires pour convaincre vos chefs de vous laisser faire la mise à jour d'une version viellotte, voici un résumé :


 * Depuis la, vous pouvez avoir un aperçu des modifications avant sauvegarde aussi sous forme de différentiel.
 * Depuis la, un bouton annuler est disponible.
 * Depuis la, le patrolling des Special:NewPages est beaucoup plus facile.
 * Depuis la, vous pouvez renommer (déplacer) les fichiers.
 * Depuis la, vous pouvez corriger les doubles redirections automatiquement.
 * Depuis la, est disponible.
 * Si vous avez un mécanisme de cache adapté, depuis la 1.17 optimise beaucoup la vitesse de chargement des pages.
 * Depuis la 1.17, le tri sur les catégories a un sens! (particulièrement pour les lettres non anglaises); étendu à 68 langues après.
 * Depuis et, les utilisateurs de toutes les langues ainsi que les genres sont correctement adressés par l'interface ainsi que dans les journaux (avant la 1.15, les genres n'existaient pas du tout).
 * Dans la le système d'habillage a été recodé rendant plus facile la réutilisation des parties d'habillages existants dans vos propres habillages.
 * Depuis la 1.20, les diffs sont plus lisibles.
 * Dans la 1.21 et la 1.23, les notifications par courriel sont plus claires et plus prévisibles, rendant votre wiki plus efficace.
 * Depuis la 1.22, la chasse aux vandales (patrolling) demmande moins de temps pour s'exécuter.
 * Dans la 1.24, l'enregistrement des mots de passe a été amélioré pour permettre une meilleure sécurité.
 * A partir de la 1.25, des modifications récentes élargies sont disponibles
 * En 1.26, le fonctionnement du "ResourceLoader" a été amélioré
 * Dans la 1.27, la gestion des sessions a été recodée tout comme la gestion de l'authentification des utilisateurs qui a été complètement modernisée. InstantCommons n'a plus besoin de fichiers en local.
 * Depuis, le cache du HTML généré pour les pages d'articles a été amélioré.
 * Depuis la, l'API Action a été recodée et améliorée. Egalement, les permissions du groupe des utilisateurs peuvent maintenant être faites pour une période définissable. Permet de bloquer une plage d'adresses IP.
 * Depuis, les utilisateurs bloqués ne peuvent pas modifier leur adresse courriel. La possibilité de rechercher les contributions à l'intérieur d'intervalles d'adresses IP dans les Special:Contributions a été ajoutée.
 * Depuis, quelques extensions font maintenant partie du noyau, telles , , . La a été présentée. La limite du taux par défaut de 90 modifications par minute a été ajoutée à tous les utilisateurs.
 * Depuis, MediaWiki prend en charge plus de 350 langues.
 * Depuis, MediaWiki prend en charge les « blocages partiels » , où les adresses IP et les comptes peuvent être restreints quant à la modification des pages ou d'espaces de noms particuliers.
 * Depuis, davantage d'extensions font partie du noyau : (pour les modules Lua), ,.
 * Depuis (version LTS stable),  est une partie du noyau. La fonctionnalité de suivi peut être enrichie avec les dates d'expiration.

Egalement, à partir de nous commençons à embarquer quelques extensions vitales, comme un  meilleur éditeur et les outils anti-vandales ConfirmEdit and Nuke; d'autres extensions ont été ajoutées dans les dernières versions. <section end=FAQ /> <span id="See_also">

Voir aussi

 * Un article du blog de Greg Sabino Mullane offre plus de détails sur les mises à jour mineures.
 * Le support si vous avez besoin d'aide ou si quelque chose s'est mal passé
 * - si votre sauvegarde ne s'est pas bien réalisée
 * - si votre sauvegarde ne s'est pas bien réalisée
 * - si votre sauvegarde ne s'est pas bien réalisée
 * - si votre sauvegarde ne s'est pas bien réalisée
 * - si votre sauvegarde ne s'est pas bien réalisée