Né en 2015, Strapi s'est rapidement imposé comme le CMS headless open-source de référence. Son nom, dérivé de "Bootstrap your API", reflète parfaitement sa mission : simplifier la création d'APIs tout en offrant une flexibilité maximale aux développeurs.

Après des années d'évolutions et de succès croissant, la plateforme franchit aujourd'hui une nouvelle étape avec sa version 5. Cette nouvelle mouture, disponible depuis six mois, apporte des améliorations majeures en termes de performances, de sécurité et d'expérience développeur.

Notre équipe qui utilise Strapi dans ses projets découplés a pu explorer ces nouveautés. Fort d'une communauté de plus de 65K stars sur GitHub et près de 1000 contributeurs actifs, Strapi continue d'innover pour répondre aux besoins des architectures modernes. Examinons en détail les innovations techniques qui font de Strapi v5 une évolution significative dans l'écosystème des CMS headless.

Les évolutions majeures par rapport à la v4

D'un point de vue technique, Strapi v5 introduit quatre évolutions majeures qui transforment significativement la plateforme. Au cœur de cette évolution, la réécriture complète en TypeScript assure une maintenance simplifiée grâce au typage fort, une détection plus rapide des erreurs et une documentation native plus robuste. 

Sur le plan des performances, l'optimisation est impressionnante avec une réduction de 30-40% des temps de réponse API, une meilleure gestion des requêtes complexes et de la mémoire couplée à un système de cache intelligent.

L'architecture des plugins a été entièrement repensée avec une refonte complète offrant plus de flexibilité et de modernité. Cette refonte s'accompagne d'un nouveau SDK dédié aux plugins, incluant notamment la commande npx @strapi/sdk-plugin init qui simplifie considérablement le développement et la compilation des extensions.

Pour couronner le tout, la sécurité a été considérablement renforcée grâce à l'intégration native d'OAuth 2.0 et OpenID Connect, un système d'audit logs, une gestion fine des tokens JWT et une protection accrue contre les attaques modernes.

Les 5 nouveautés qui changent la donne pour les développeurs avec Strapi 5

La gestion des brouillons enfin native

Strapi v5 intègre enfin nativement la gestion des versions brouillon, une fonctionnalité très attendue. Fini le recours aux plugins tiers : vous pouvez désormais préparer sereinement vos modifications sur un contenu déjà publié sans impacter la version en ligne.

Document Service API : une API plus intuitive

La nouvelle Document Service API remplace l'Entity Service avec des améliorations notables.
Nouveautés clés :

• Méthodes publish(), unpublish() et discardDraft()

• Fonction count() native

• IDs aléatoires pour plus de sécurité

APIs simplifiées : moins de complexité

La structure de réponse des APIs REST et GraphQL a été simplifiée, cette amélioration réduit la verbosité et augmente la lisibilité du code, rendant les interactions avec les APIs plus fluides et intuitives.

Il est également important de noter l'impact sur le frontend car la nouvelle structure de réponse API de Strapi v5, bien que plus simple et performante, nécessite une adaptation significative de votre code. Contrairement à la version 4, qui imbriquait les données dans des objets data et attributes, la version 5 adopte une structure aplatie plus directe. Par exemple, pour accéder au titre d'un article, vous passerez de response.data.attributes.title à simplement response.data.title.

Outil de migration : une transition facilitée

La migration vers Strapi v5 est simplifiée grâce à un nouvel outil CLI dédié. Cet outil en ligne de commande (@strapi/upgrade) guide les développeurs à travers les différentes étapes de la migration tout en automatisant les tâches répétitives. 

npx @strapi/upgrade check

Cette commande analyse votre projet Strapi v4 et génère un rapport détaillé comportant :

• Les incompatibilités potentielles

• Les dépendances à mettre à jour

• Les modifications de code nécessaires

• Les fichiers de configuration à adapter

npx @strapi/upgrade prepare

L'outil prépare votre projet en :

• Sauvegardant les fichiers critiques

• Mettant à jour le package.json

• Adaptant la structure du projet

• Générant les fichiers de configuration v5

npx @strapi/upgrade migrate

Cette dernière étape :

• Convertit automatiquement les fichiers compatibles

• Met à jour les modèles de données

• Adapte les configurations

• Génère un rapport de migration

Malgré l'automatisation, certains aspects nécessitent une intervention manuelle comme l’adaptation des plugins personnalisés, la mise à jour des requêtes API complexes, la migration des hooks spécifiques et les ajustements sur des configurations avancées.

Historique du contenu

Fini les sueurs froides lors des modifications accidentelles ! La version 5 introduit un système d'historique complet (disponible seulement en licence Enterprise) permettant de :

• Suivre les modifications

• Restaurer des versions antérieures

• Comparer les différentes versions

Faut-il migrer vers la version 5 ?

Strapi 5 est la dernière version stable, mais Strapi v4 est encore supporté jusqu'en mars 2026, ce qui signifie que les correctifs de sécurité sont toujours appliqués à la version 4.

Avant toute migration, un audit complet de vos plugins est nécessaire car la version 5 de Strapi introduit des changements architecturaux majeurs, notamment avec l'adoption de TypeScript, le changement du système d'événements et une nouvelle approche de la gestion des plugins, pour utiliser les nouvelles API de Strapi v5 concernant la gestion des données et les interactions avec le core. Ces modifications impactent directement le fonctionnement des plugins existants qu'ils soient officiels, communautaires ou développés en interne.

La migration vers Strapi v5 représente un investissement significatif mais justifié par les améliorations apportées. Au-delà des gains immédiats en performances et en sécurité, cette version pose les fondations pour l'intégration future de fonctionnalités avancées comme l'IA générative et l'automatisation poussée des workflows de contenu. Pour les équipes utilisant déjà la version 4, la transition est relativement fluide grâce aux outils de migration fournis, même si certains ajustements restent nécessaires, particulièrement au niveau des personnalisations existantes.