SPIP

Migration d'un SPIP 1 ou 2 vers SPIP 3.2.19

Pierre KUHN — 2026-04-15T18:35:00Z

Cette documentation concerne le passage d'un SPIP 1 ou 2 vers SPIP 3.2.19

La méthode proposée permet de partir sur des bases saines en effectuant un grand ménage dans les fichiers de SPIP et de repartir à zéro sur de nouveaux plugins (SPIP permet d'installer des plugins très rapidement).

Sommaire

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érer par ftp le fichier généré : format xml pour les spip2, dans tmp/dump (ou ecrire/data pour un spip plus ancien)

Sauvegarde des dossiers personnels
- Récupérer par ftp les répertoires :

IMG
config (pour les spip très ancien munissez-vous de vos codes de base de données)
éventuellement squelettes si son contenu pourrait être réutilisé

Avec la sauvegarde de votre base de données et le dossier IMG (qui contient tous les documents et images joints à 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).

Vérification de l'encodage avant la migration

Si votre site est suffisamment récent (site en utf-8) ou si l'encodage de celui-ci est déjà en utf-8, vous pouvez passer à l'étape suivante.

Pour le savoir, voir dans les paramètres de langue.

Si l'encodage est en iso-8859-1, il est conseillé de passer votre site en utf-8. Une telle procédure est proposé dans SPIP 2 :

faire une sauvegarde de la base de données (en principe vous en avez déjà une)
dans la page de gestion des langues, cliquer sur le lien proposé vers « la page de conversion vers l'utf-8 » ( url : ecrire/ ?exec=convert_utf8)
lancer ensuite la page : ecrire/ ?exec=sql_convert_utf8

Vérification 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 PHP qui est exécutée sur votre serveur (via https://example.com/ecrire/?exec=info par exemple).
SPIP 2 fonctionne en PHP 4.x et SPIP 3 nécessite PHP en version 5.1 minimum.
Si nécessaire, voyez avec votre hébergeur comment utiliser une version récente de PHP 5.3 ou 5.4, par exemple.

Pour exécuter SPIP 3.2, il vous faut PHP 5.4 minimum donc passer d'abord votre hébergement en PHP 5.4

Télécharger SPIP 3.2.19 puis décompresser l'archive dans un dossier spip de votre ordinateur
Créer par ftp le répertoire à la racine de votre site, sur le serveur : /ancienSpip
Déplacer dedans 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

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.

Mise à jour de la base - Etape 1

Mise à jour de la base - Etape 2

Mise à jour de la base - Etape 3
Se rendre ensuite sur la page de gestion des plugins (dans configuration) afin de réactivé les plugins compatible et mettre à jour ceux qui ne le sont pas.
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 qui se trouve dans /ancienSpip. Vérifiez que chacun produit bien le résultat souhaité.

Ménage

Quand tout est terminé :

vérifier que les autres applications installées sur l'hébergement fonctionnent.
vérifier 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)
supprimer finalement le dossier /ancienSpip.

À propos de cette documentation

Auteurs

Michel Suquet
Johan Pustoch

Adaptations

Collectif SPIP

_AUTORISER_TELECHARGER_PLUGINS

Pierre KUHN — 2025-03-19T20:27:24Z

La constante _AUTORISER_TELECHARGER_PLUGINS a comme valeur par défaut true, ainsi les admins d'un site peuvent ajouter ou mettre à jour les plugins du site.

Si vous souhaitez désactiver le chargement des plugins, elle peut être définie à false dans votre fichier config/mes_options.php (voir l'article qui lui est consacré).

define('_AUTORISER_TELECHARGER_PLUGINS', false);

_MAJ_NOTIF_EMAILS

b_b, Pierre KUHN — 2024-07-26T13:12:29Z

Par défaut, SPIP 4.3 envoie un email à tou⋅tes les webmestres du site quand une mise à jour de SPIP est disponible.

Sujet : [SPIP-Contrib] La mise à jour 4.3.0 de SPIP est disponible Bonjour, Le site https://contrib.spip.net peut être mis à jour vers une nouvelle version de SPIP. Pour des questions de sécurité, il est important de garder votre site à jour.

La constante _MAJ_NOTIF_EMAILS permet de personnaliser la liste des adresses auxquelles seront envoyés ces emails. Elle peut être personnalisée dans votre fichier config/mes_options.php (voir l'article qui lui est consacré).

Par exemple, si on souhaite désactiver ces notifications (ce qui n'est pas une bonne idée) :

// désactiver les notifications de mise à jour define('_MAJ_NOTIF_EMAILS', '');

mais aussi

// n'envoyer les notifications de mise à jour qu'aux adresses séparées par une virgule define('_MAJ_NOTIF_EMAILS', 'contact@example.com,test@example.com');

|balise_svg

JLuc, Pierre KUHN — 2022-03-31T16:40:17Z

Le filtre |balise_svg permet d'intégrer le code d'une image svg dans le HTML, afin de l'afficher.

Sommaire

Paramètres optionnels

Depuis SPIP 4.0, la balise |balise_img prends en charge les images svg. Les fichiers SVG sont alors référencés en tant que valeur de l'attribut src d'une balise img.

Le filtre |balise_svg permet, quant à lui, d'insérer directement dans le HTML le contenu du fichier SVG, avec ou sans attribut alt selon les bonnes pratiques [1].

Ce sera utile pour de petites icônes, ou lorsqu'on veut bénéficier des attributs title définis à l'intérieur du SVG.

Paramètres optionnels

Ce sont les mêmes que ceux du filtre |balise_img (voir les détails) :

alt texte alternatif ; une valeur nulle pour explicitement ne pas avoir de balise alt sur l'image (au lieu d'un alt vide)
class null par defaut
size permettant de spécifier la taille du rendu - à partir de SPIP 4.0.

[(#CHEMIN{img/trash.svg}|balise_svg{<:auted:supprimer_modele_autorisation:>, icone_svg, 24x24})]

produira le tag :

Voir aussi : Recommandations pour les icônes SVG utilisées dans l'interface SPIP

[1] telles que décrites par https://www.accede-web.com/notices/html-et-css/images-et-icones/gerer-lalternative-des-svg-images-vectorielles

#CONST

peetdu, Pierre KUHN — 2018-10-24T13:10:55Z

La balise #CONST{nom_de_constante} retourne la valeur de la constante passée en argument. Si la constant n'est pas définie, la balise ne retourne rien [1].

Sommaire

Exemples

// Voir le contenu de la partie Composed-By de l'entête HTTP des pages générées par SPIP #CONST{_HEADER_COMPOSED_BY}

retournera par défaut Composed-By: SPIP
Autre exemple
Dans le fichier config/mes_options.php :

define('_ID_MOT_TRUC',xx);

puis dans un squelette

Voir aussi

Le fichier mes_options.php
la liste complète des constantes et des variables de personnalisation dans le glossaire.

Les balises

[1] Et ne provoque pas d'erreur.

#URL_ECRIRE

Committo, Ergo Sum., Pierre KUHN — 2012-12-15T23:55:00Z

La balise #URL_ECRIRE fabrique l'URL d'un script de l'espace privé s'il existe.

Cette balise permet d'écrire des liens vers les scripts ?exec de l'espace privé.

Ainsi, [ ... ] va appeler /ecrire?exec=unscript.

Si le script n'existe pas (c'est-à-dire s'il n'existe pas de fichier du nom indiqué, dans les répertoires exec connus de SPIP et des plugins installés), cette balise ne retourne rien, et conséquemment tout l'extrait de squelette ci-dessus retournera la chaîne vide. C'est très pratique pour ne produire un lien que si le plugin qui y répond est installé.

Il est possible de compléter l'URL par une Query-String, en la donnant en deuxième argument à la balise :

#URL_ECRIRE{formulaires_voir,id_formulaire=#ID_FORMULAIRE}

S'il y a besoin de passer plus d'un paramètre, ou peut aussi faire appel au filtre parametre_url

Sans aucun argument, cette balise retourne l'URL de la page d'accueil de l'espace privé.

Pour des informations sur écrire Étendre SPIP

Pour générer une URL de l'espace public, on utilisera #URL_PAGE