Sauvegarde avant la migration
Sauvegarde de la base de données
- Si vous en avez la possibilité, il est sage de faire une sauvegarde de la base MySQL via PHPMyAdmin, disponible sur beaucoup d’hébergements, en faisant le choix d’une sauvegarde compressée.
- SPIP propose aussi un système de sauvegarde (récupérez par ftp le fichier généré dans tmp/dump)
Sauvegarde des dossiers personnels
- Récupérez par ftp les répertoires :
- IMG
- config
- squelettes si son contenu doit être réutilisé
Avec la sauvegarde de votre base de données et le dossier IMG (qui contient tous les documents et images joints de votre site), vos contenus sont sauvegardés. config contient les infos de connexion à la base de données et squelettes vos personnalisations de squelette. Notez éventuellement la version précise de SPIP utilisée avant cette migration.
Mise à jour des plugins
Penser à mettre à jour vos plugins pour limiter les incompatibilités.
Les plugins non compatibles seront désactivés lors de l’installation de la nouvelle version.
Préparation de la migration
Vérifiez la version de PHP qui est exécutée sur votre serveur via https://example.com/ecrire/?exec=info.
SPIP 3 fonctionne avec les version PHP 5.4 à 7.4 et SPIP 4.4 nécessite PHP en version 7.4 minimum.
Ensuite vous aurez 2 possibilités pour la migration :
Solution manuelle
- Téléchargez la dernière version de SPIP (Télécharger SPIP) puis décompressez l’archive dans un dossier spip de votre ordinateur
- Créez par ftp le répertoire à la racine de votre site, sur le serveur : /ancienSpip
- Déplacez dans celui-ci tous les dossiers plugins plugins-dist prive ecrire squelettes squelettes-dist local tmp et fichiers spip.php index.php, mais pas les dossiers config IMG
- Transférer par ftp les répertoires et fichiers contenus dans le dossier local spip de votre ordinateur vers le dossier distant
Solution recommandée avec spip_loader.php
- Récupérez le fichier spip_loader.php (ou copiez juste son contenu) sur votre ordinateur à partir de la page Télécharger SPIP
- Déposez ce fichier à la racine de votre site, par FTP en mode binaire
- Visitez votre site avec votre navigateur habituel et lancer la page spip_loader.php, en vous rendant à l’adresse du style : https://example.com/spip_loader.php et suivez les indications.
Mise à niveau de la base
En fonction du type de mise à jour, une procédure de mise à niveau de la base de données vous sera proposé en accédant à l’espace privé. Suivez les indications.
- Consulter votre site. Normalement, il devrait s’afficher (sous l’apparence des squelettes par défaut de SPIP)
- Se connecter sur l’interface privé de SPIP avec un compte administrateur (en cas de difficulté, se rendre à l’url /ecrire du site).
- Suivre la procédure de maintenance proposée.
- Se rendre ensuite sur la page de gestion des plugins (dans configuration)
- Vérifier que le site fonctionne.
En cas de problème
Si besoin (si on n’arrive plus à accéder à l’espace privé du site, si des erreurs récurrentes s’affichent), il peut aussi être utile de réinitialiser certains fichiers temporaires de SPIP.
Il s’agit de vider le répertoire tmp sauf éventuellement les sous-répertoires dump, sessions et visites.
Pour cette opération : aller dans le dossier tmp et effacer tout sauf les dossiers dump et visites. Il vous faudra ensuite vous reconnecter.
Si un problème persiste, venez poser vos question sur le forum : https://discuter.spip.net/c/spip/6
Installation des plugins et squelettes
Créer les dossier suivant à la racine de votre site :
- /plugins (puis dans ce dossier, créer le dossier auto)
- /lib
- /squelettes
Adaptez les droits de ces dossiers pour que le serveur puisse y écrire.
Se rendre dans l’interface de gestion des plugins et, dans « dépôts », utiliser le dépôt proposé - (important pour la mise en œuvre de la nouvelle gestion des plugins).
Installez les plugins nécessaires (les rechercher dans le moteur de recherche) au fonctionnement de votre site. Vérifiez que le site public fonctionne (éventuellement, vider le cache ou le répertoire tmp comme expliqué ci-dessus). Repassez en revue les réglages des plugins (cliquez sur l’icône de configuration après les avoir activés).
Rétablissez enfin si besoin vos personnalisations de squelettes en remettant progressivement les fichiers html dans votre dossier squelettes. Vérifiez que chacun produit bien le résultat souhaité.
Ménage
Quand tout est terminé :
- vérifiez que les autres applications installées sur l’hébergement fonctionnent.
- vérifiez le contenu du dossier /ancienSpip. Celui-ci ne devrait contenir que des dossiers et fichiers issus de votre ancien SPIP (ecrire, local, tmp, squelettes-dist ou dist, extensions et quelques fichiers)
- supprimez finalement le dossier /ancienSpip.
À propos de cette documentation
Auteurs
- Michel Suquet
- Johan Pustoch
Adaptations
Collectif SPIP