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

_DIR_PLUGIN_XXX

JLuc — 2026-03-10T15:00:33Z

La constante _DIR_PLUGIN_TRUC indique le chemin du dossier où est installé le plugin truc.

On peut s'en servir en PHP pour inclure des fichiers de ce plugin :

include_once _DIR_PLUGIN_TRUC . 'inc/une_inclusion.php;'

Toutefois, pour que d'autres plugins puissent surcharger l'inclusion, on préférera ne pas utiliser cette constante mais la fonction include_spip, car celle-ci parcourt tous les chemins accessibles :

include_spip( 'inc/une_inclusion.php);

Voir : fonction include_spip

_IFRAME_SAFE_DOMAINS

JLuc — 2026-02-17T18:04:41Z

Par mesure de sécurité, les iframes sont masquées dans l'espace privé à partir de SPIP 4.4.8, sauf pour les domaines explicitement autorisés via une constante _IFRAME_SAFE_DOMAINS.
Cette constante doit contenir un tableau d'expression régulières décrivant tous les domaines autorisés, sans protocole, sans chemin et sans '/' à la fin.
Exemple : define ('_IFRAME_SAFE_DOMAINS', [ 'fr\.wikipedia.org', '.*\.spip\.net']) ;

- Variables et Constantes de personnalisation / SPIP 4.4, _IFRAME_SAFE_DOMAINS

#VIRTUEL

JLuc — 2025-05-08T15:17:39Z

Cette balise renvoie la valeur du champ de redirection saisi pour un article (cette saisie se fait dans la colonne secondaire de la page d'édition d'un article).
Cette possibilité doit avoir été activée dans la page de configuration "Contenu du site".

- Balises / BOUCLE(ARTICLES), #VIRTUEL

{virtuel}

JLuc — 2025-05-08T10:18:28Z

Le critère {virtuel} d'une boucle ARTICLES permet de ne retenir que les articles virtuels (qui redirigent vers une autre url).

Inversement, avec {virtuel=''} ou {!virtuel} , la boucle ne retournera que les articles non redirigés.

Voir : #VIRTUEL

Utiliser Rector

bricebou — 2025-03-20T13:43:48Z

Rector est un outil de refactoring et d'amélioration automatisé de code PHP ; SPIP s'est doté d'un jeu de règles : https://git.spip.net/spip-league/rector.

Sommaire

Préalable

Il faut un fichier composer.json à la racine du plugin, dans lequel on déclare le dépôt composer propre à SPIP :

{ "repositories": { "spip": { "type": "composer", "url": "https://get.spip.net/composer" } } }

Installation

composer require --dev rector/rector spip-league/rector:"dev-main"

Configuration

La configuration se fait dans le fichier rector.php à la racine de votre plugin :

withPaths([__DIR__]) ->withRootFiles() ->withSets([SpipSetList::SPIP_41, LevelSetList::UP_TO_PHP_74]) ->withSkip([ __DIR__ . '/lang', __DIR__ . '/vendor', ]) ;

On peut configurer des scripts dans le fichier composer.json :

 "scripts": { "rector": "vendor/bin/rector process --ansi", "rector-dry-run": "vendor/bin/rector process --dry-run --ansi" }

Usage

composer rector-dry-run composer rector composer rector dossier/fichier

Utiliser ECS

bricebou — 2025-03-20T13:40:49Z

SPIP propose un jeu de règles pour Easy Coding Standard (https://github.com/easy-coding-standard/easy-coding-standard) via le dépôt spip-league/easy-coding-standard.

L'utiliser permet de s'assurer de respecter les conventions d'écriture PHP utilisées dans la communauté SPIP.

Sommaire

Préalable

Il faut un fichier composer.json à la racine du plugin, dans lequel on déclare le dépôt composer propre à SPIP :

{ "repositories": { "spip": { "type": "composer", "url": "https://get.spip.net/composer" } } }

Installation

L'installation se fait avec la commande :

composer require --dev spip-league/easy-coding-standard

Configuration

Créez le fichier ecs.php à la racine de votre plugin :

withSets([SetList::SPIP]) ->withPaths([__DIR__]) ->withRootFiles() ->withSkip([__DIR__ . '/lang', __DIR__ . '/vendor']) ;

Usage

Pour en faciliter l'usage, on peut ajouter des "alias" dans les scripts du fichier composer.json :

 "scripts": { "check-cs": "vendor/bin/ecs check --ansi", "fix-cs": "vendor/bin/ecs check --fix --ansi" }

composer fix-cs composer fix-cs inc/inc.inc

_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);

SPIP 4.4

b_b — 2025-02-14T13:30:11Z

Cette branche LTS [1] va bénéficier d'un support étendu jusqu'en juillet 2028.

Sommaire

Compatibilité PHP 7.4 à 8.5

SPIP 4.4 nécessite PHP 7.4 minimum, et fonctionne jusqu'à PHP 8.5.
Il nécessite les extensions PHP : sodium, Zlib, Zip et Phar.

Changements apportés par SPIP 4.4

Les changements les plus marquants sont le fait que SPIP n'envoie plus de mot de passe en clair dans les mails d'inscription et de rappel de mot de passe.

Côté technique on peut noter que les dossiers ecrire, prive, squelettes-dist ainsi que l'écran de sécurité s'installent avec Composer. Cela ne change rien pour les personnes qui utilisent spip_loader. À noter aussi, l'introduction des balises #LAYOUT_PRIVE, #TRAD et #URL_DOCUMENT_FICHIER.

On peut également noter une série d'optimisations pour les filtres d'images.

La balise #LAYOUT_PRIVE remplace #LARGEUR_ECRAN et permet d'utiliser de nouvelles dispositions pour les pages de l'espace privé :

#LAYOUT_PRIVE{fluide}, le contenu central s'adapte selon la présence ou pas de contenu dans #extra et #navigation.

#LAYOUT_PRIVE{pleine-largeur}

#LAYOUT_PRIVE{complements-gauche}

#LAYOUT_PRIVE{complements-droite}

#LAYOUT_PRIVE{complements-bas}

#LAYOUT_PRIVE{complements-bas-inverse}

La balise #TRAD permet d'éviter les écriture du style #VAL{module:cle}|_T, exemple #TRAD{module:cle, #ARRAY{param, val, ..}, #ARRAY{option, val..}}.

Répertoires

- Le répertoire vendor/ se complète, avec l'arrivée de premières librairies spip-league, qui vont faire une première passerelle vers des éléments du futur SPIP 5.0
- À ce titre, un répertoire config/spip est maintenant présent également

Cette version apporte également d'autres améliorations ou corrections de bugs.

Sécurité

Nettoyer certaines entrées auteurs sur le formulaire d'édition d'auteur (évite de se retrouver dans des logs, si des logs verbeux sont activés)
Mise à jour de la liste des bots & ajout de antennapod (lecteur RSS) comme bot licite

Ajouts

Ne pas envoyer de mot de passe en clair, mais plutôt des liens pour définir son mot de passe
copie_locale() passe une clé action au pipeline post_edition
Chaînes de langue supplémentaire pour les listes d'articles
Balise #LAYOUT_PRIVE
Balise #TRAD{module:cle, #ARRAY{param, val, ..}, #ARRAY{option, val..}}
Balise #MIME_TYPE calculée
Balise #URL_DOCUMENT_FICHIER renvoyant toujours le fichier d'un document, ce qui permet quand on le souhaite d'utiliser #URL_DOCUMENT pour renvoyer vers une page web. Les modèles de document sont mis à jour pour utiliser cette balise.
Les actions ajouter_lien et supprimer_lien peuvent gérer un qualificatif
Pipeline ajouter_menus_args, en complément au pipeline ajouter_menus, qui transmet les arguments de definir_barre_boutons()
Purger les variables de var_nullify du contexte dans traiter_appels_inclusions_ajax
Balise #PARAM pour récupérer les paramètres du container de services
Le filtre |affdate accepte un timestamp en entrée
Fonction _image_extensions_logos() et pipeline image_extensions_logos
Commande cli pour purger les images cache trop anciennes (cache-gd2 et cache-vignettes)
Filtre image_oriente_selon_exif() pour réorienter automatiquement une image selon son exif

Changements

Les dossiers ecrire, prive, squelettes-dist s'installent avec Composer
L'écran de sécurité s'installe avec Composer
Mise à jour des chaînes de langues depuis trad.spip.net
Utiliser le pipeline compter_contributions_auteur dans la boite d'info d'un auteur
Possibilité de personnaliser les chaînes de langue singulier et pluriel du titre de toutes les listes d'objets
Nouveaux layouts pour le privé (#LAYOUT_PRIVE) : defaut, fluide, pleine-largeur, complements-droite, complements-bas, complements-bas-inverse
Les valeurs d'environnement explicitement vidées en ajax passent par var_nullify pour en être totalement expurgées
Permettre de trier les comptes visiteurs "nouveau" par date d'inscription-relance
Ajouter l'heure de publication à côté de la date
Utiliser des variables CSS et propriétés logiques dans l'espace privé pour éviter la compilation des fichiers CSS
La page de contrôle des tâches utilise le layout complement-gauche
Utilisation de image_extensions_logos() à la place de $GLOBALS['formats_logos']
Les filtres d'images tel que image_recadre réorientent l'image selon l'exif d'orientation

Corrections

Dans l'espace privé, éviter une scrollbar horizontale dans certaines configurations de systèmes d'exploitation.
Aligner le contenu de la bande en_lignes avec celui du bandeau
Meilleur affichage des listes d'objets sur petit écran
Pas de marge basse sur les derniers éléments des réponses
Charger l'autoloader dans le fichier prive.php
Éviter un warning PHP si le fichier du logo n'est pas présent
Suivre medias sur inc_vignette_dist qui attend un paramètre medias
Rétablir le masquage des documents vus dans le bloc des documents
Ne plus déclarer de z-index sur les colonnes qui sont déjà en flex
Réparer la rotation des images avec convert
Pouvoir scroller après avoir quitté le mode plein écran via la touche
Utiliser pour IMAGETYPE_SVG une valeur qui ne risque pas une collision avec un futur ajout de format image (19 a été pris par IMAGETYPE_AVIF entre temps)
Correction d'une erreur fatale sur l'appel à phraser_champs_interieurs()
Utiliser fpassthru() pour livrer directement les fichiers et éviter un memory limit plutôt que readfile() qui passe par un chargement en mémoire du fichier
Requêter les fichiers distants avec STREAM_CRYPTO_METHOD_TLS_CLIENT
Remplacer les balises tt obsolètes par code
Les emails des auteurs sont masqués par défaut
Transmettre au pipeline compter_contributions_auteur le nombre de contribution sur les articles
Passer l'url à l'item de langue pass_reset_url
Pour le formulaire générique d'institution d'objet, tester l'autorisation publierdans en utilisant le parent déclaré par l'API de parenté
Dans le formulaire générique d'institution d'un objet, utiliser le même jeu de test pour l'affichage du statut publie dans charger et pour la validation dans verifier
Pouvoir supprimer l'image de l'écran de connexion
Pouvoir modifier logo principal quand il y a un logo de survol
Inclusion manquante dans certains contextes ajax pour bigup
Vérifier l'existence de exif_read_data()
Éviter des warnings sur image_oriente_selon_exif() en absence d'image
Optimisation des filtres image_aplatir(), image_renforcement(), image_flou(), image_sepia(), image_flip_vertical(), image_flip_horizontal(), image_nb(), image_gamma() & image_rotation()
Correction du paramètre crop de image_rotation()
Message de retour des formulaires en div plutot qu'en p
Le mimetype audio/x-m4a est un alias de audio/mp4a-latm
Appel à la globale $formats_logos remplacée par _image_extensions_acceptees_en_entree()
Corriger la duplication (plugin Duplicator par exemple) de logo si le dossier tmp/upload n'existe pas
Affichage du sélecteur de rôles de documents (avec le plugin en question)
Affichage des aperçus dans les modèles emb
Correction du chemin des plugins de la librairie mediaelements et suppression du fallback Flash
Ajouter le pipeline afficher_config_objet qui manquait sur les pages mots et groupes_mots.
Dédoublonner test de statut dans une requête SQL.
Support de la branche 4.4 de SPIP dans le référentiel des plugins
Invalider le cache (même pour les bots) lorsqu'une URL permanente est ajoutée

Dépréciations

Inclusion de fichier PHP via ou
Balise fermante
Balise #LARGEUR_ECRAN pour les squelettes du privé à remplacer par #LAYOUT_PRIVE
À partir de SPIP 5, l'appel des chaînes de langues en squelette sera sensible à la casse de la déclaration, il n'y aura plus de conversion automatique en minuscule
Fonction interne phraser_boucle_placeholder() à remplacer par phraser_placeholder_memoriser() ou phraser_placeholder_reinjecter()
Fonction interne public_generer_boucle_placeholder() à remplacer par public_placeholder_generer()
Les fichiers de langue peuplant une $GLOBALS sont dépréciés ; renvoyer directement un tableau
Constante obsolète _DIR_IMG_PACK
Globales $traiter_math, $tex_server, fonctions produire_image_math(), traiter_math() et replace_math(), utiliser le plugin mathjax à la place
Modifier la globale $formats_logos est déprécié : utiliser le pipeline image_extensions_logos
Appeler la globale $formats_logos est déprécié, utiliser la fonction _images_extensions_logos()
Dépréciation de la constante _DIR_RESTREINT_ABS
Filtre |image_typo, et fonctions rtl_mb_ord(), rtl_reverse(), rtl_visuel(), printWordWrapped(), produire_image_typo(), installer le plugin Images typographiques

Retraits

Fonctions verif_butineur(), editer_texte_recolle() et environnement _texte_trop_long des formulaires (inutilisé — servait pour IE)
Prise en compte de l'environnement de formulaire _texte_trop_long (servait pour IE)
Un fichier de langue obsolète et non traduit.

Plugins compatibles

Comme pour la version précédente, la plupart des plugins sont déjà compatibles avec SPIP 4.4, ce qui facilitera les mises à jour.
Voir : Effectuer une mise à jour

[1] https://fr.wikipedia.org/wiki/Long-term_support

Les outils utilisés pour le développement

bricebou, b_b, James, Maïeul, Matthieu Marcillaud, placido, tofulm — 2025-01-14T06:58:03Z

L'équipe de maintenance utilise ces outils pour maintenir et développer SPIP. Cet article résume succinctement le rôle des outils et les liens de documentation.

Nom de l'outil	Rôle	Documentation spécifique à la communauté SPIP

Développement côté serveur ou back-end
PHP	Langage dans lequel SPIP est écrit côté serveur
PHPdoc	Commentaire du code
Composer	Installer les bibliothèques de code (library) dont le projet principal a besoin
Qualité de code
Easy Coding Standard	Automatiser le respect des régles de codages	Utiliser ECS
Rector	Corriger du code historique pour le rendre plus durable	Utiliser Rector
PSR	Bonne pratiques de codage	Conventions
PHPUnit	Tester le code
PHPStan	Analyser le code
Refactoring Guru	Inspiration pour transformer le code procédural historique en code POO et pour gagner en robustesse
The Twelve-Factor App	Inspiration : une méthodologie pour concevoir des logiciels en tant que service

Développement côté navigateur ou front-end
Javascript	Langage pour l'affichage dynamique de fragments de page (front-end)
jQuery	Bibliothèque longtemps restée comme référence (en voie de migration)
npm + Bun	Installer des modules ou bibliothèques de code (library)
Qualité de code
bun:test	Tester le code
biomejs	Normaliser le code (linter)

Versionnage
Git	Suivi de version de code	Consulter un livre en français
Gitlab	Plateforme de développement
Sémantique	Comment fonctionnent les versions de SPIP et de ses dépendances
Conventionnel commit	Des messages des commits signifiants, lisibles pour l'humain	Voir aussi Écrire un message de commit
Changelog	Permettre de voir précisément quels changements notables ont été faits entre chaque publication (release) d'un projet	Voir aussi Tenir un CHANGELOG

Nous développons et utilisons aussi nos propres outils :

- spip-releases
- spip-league/ecs
- spip-league/rector
- spip-league/sdk