Guide de migration vers SPIP 5.0¶

Ce guide vous accompagne dans la mise à jour de vos sites et plugins de SPIP 4.x vers SPIP 5.0.

Sommaire de migration¶

1. Préliminaires et Prérequis

   • PHP 8.2+
   • Migration de la base de données
   • Nouveau layout des plugins-dist/

2. Environnement et Kernel

   • Variables d'environnement .env
   • Configuration du Kernel

3. Squelettes et Syntaxe

   • Parties optionnelles des balises
   • Casse des items de langue
   • Inclusions PHP supprimées

4. API PHP et Fonctions

   • Système de Log (PSR-3)
   • Fonctions supprimées ou renommées
   • Constantes migrées vers le Kernel

5. Migrer les pipelines

   • Fonction pipeline() et EventDispatcher
   • Listeners typés et events dédiés
   • Changements runtime des anciens caches

6. Migrer les pipelines d'un plugin

   • Remplacement des fonctions prefixe_pipeline()
   • Déclaration via config/services.php
   • Tests unitaires des listeners

7. Javascript et Assets

   • Modules ESM
   • Émancipation de jQuery
   • Migration des balises <script> et <style>

8. Espace privé et Menus

   • Renommage des pages et menus
   • Modifications de l'UI

9. Dépréciations et Suppressions

   • Récapitulatif des éléments retirés
   • Conseils de remplacement