Effectuer une mise à jour

Cet article vous explique comment mettre à jour votre site SPIP lorsqu’une nouvelle version est disponible.

Comprendre les numéros de versions

Un numéro de version de SPIP s’écrit toujours de la forme X.Y.Z : par exemple, 3.1.5

On peut distinguer trois types de mises à jour :

Mise à jour majeure X évolue Par exemple :
de SPIP 3.1.5 à SPIP 4.0.0
Mise à jour mineure Y évolue Par exemple :
de SPIP 3.0.11 à SPIP 3.1.0
Mise à jour de maintenance Seul le Z évolue Par exemple :
de SPIP 3.2.10 à SPIP 3.2.11

Lors de la sortie d’une nouvelle version de SPIP, tout utilisateur verra apparaître un message dans le bas des pages de l’espace privé lui annonçant la disponibilité de cette version.
Cette annonce varie selon le type de mise à jour :

  • mise à jour mineure ou majeure : le message « Une nouvelle version SPIP X.Y.Z est disponible » est affiché ;
  • mise à jour de maintenance : le message « La mise à jour X.Y.Z de SPIP est disponible » est affiché.

Pour les mises à jour majeures (de SPIP 1.x à 2.x ou 3.x ou 4.x),
Consulter Changer la version majeure de SPIP

Effectuer une mise à jour de maintenance (par exemple, de SPIP 3.2.0 à SPIP 3.2.1) est très simple, et il est recommandé de procéder régulièrement à ces mises à jour.

Étape 1. Sauvegardez votre base de données.

Avant toute modification importante, comme une mise à jour, il est toujours conseillé d’effectuer une sauvegarde de précaution.
Notez bien : il s’agit uniquement d’une précaution. Vous n’êtes pas obligé de l’effectuer, et le fichier de cette sauvegarde ne vous servira plus une fois la mise à jour terminée.

La procédure de sauvegarde est expliquée dans cet article : « Sauvegarder vos données ».

Étape 2. Mettez à jour vos plugins

Rendez vous sur la page "Gestion des plugins" (dans le menu "Configuration"), et en dessous de la liste des plugins, cliquez sur "Cochez les mises à jour" puis "Appliquer".

Étape 3. Installez la nouvelle version de SPIP

La méthode la plus simple est d’utiliser « spip_loader », qui effectue l’installation automatique des fichiers.

Cet article vous indique la marche à suivre : Utiliser spip_loader

L’autre méthode, plus traditionnelle, consiste à télécharger la dernière version de spip pour installer les fichiers de SPIP une nouvelle fois, exactement comme vous l’aviez fait lors de la première installation, en décompactant SPIP sur votre propre disque dur et en envoyant tous les fichiers par FTP chez votre hébergeur.

Mettez à jour votre fichier .htaccess

Chaque fois qu’une version paraît, il se peut qu’il y ait une mise à jour du fichier htaccess.txt qui sert de base pour le fichier .htaccess de votre site. Vous devez donc mettre ce dernier à jour : reportez vos réglages personnalisés dans la partie #REGLAGES PERSONNALISES# du nouveau fichier htaccess.txt et renommez-le .htaccess.

Étape 4. Déclenchez la mise à niveau de votre site

Une fois tous les fichiers réinstallés (par FTP, ou automatiquement avec « spip_loader »), rendez vous dans l’espace privé de votre site.

Notez bien : attendez que tous les fichiers soient bien installés chez votre hébergeur. Inutile d’essayer d’intervenir sur votre site pendant le transfert des fichiers, vous obtiendriez des résultats incohérents...

En fonction du type de mise à jour, vous pouvez obtenir le message suivant :
« Message technique : la procédure de mise à jour doit être lancée afin d’adapter la base de données à la nouvelle version de SPIP. »
En tant qu’administrateur, suivez le lien proposé pour déclencher la mise à jour de la base de données.

Dans le cas d’une mise à jour de maintenance, vous ne verrez probablement pas ce message.

Voilà, l’opération de mise-à-jour est terminée.

Répétons ce conseil, car c’est une erreur très classique : ne réinstallez pas la base de données à partir de la sauvegarde effectuée précédemment. Cette sauvegarde correspond désormais à une ancienne structure des données, elle n’est donc plus utilisable sur la nouvelle version du site.

Que faire en cas de pépin ?

Si, après votre mise à jour, vous rencontrez des bugs ou des erreurs, vous pouvez trouver de l’aide en ligne sur le groupe de discussion des utilisateurs de SPIP.

Exposez votre question en étant le plus précis possible : quel hébergeur, à partir de quelle version avez-vous effectué la mise à jour ; n’oubliez pas de signaler si ce problème apparaissait déjà ou non dans la version précédente.

Si votre problème est un bug encore inconnu, les développeurs travailleront très rapidement sur la question pour livrer une version corrigée.

Voir aussi

Auteur L’équipe de SPIP Publié le : Mis à jour : 29/09/23

Traductions : عربي, català, corsu, Deutsch, English, Español, français, italiano, Nederlands, òc lengadocian, Português, Türkçe, українська