Comment renommer tables et colonnes dans Directus en toute sécurité (sans tout casser)

Si vous avez déjà tenté de renommer une table ou une colonne dans Directus, vous connaissez la douleur : Directus traite un renommage comme une modification structurelle. Relations, permissions, automatisations et l’application tout entière peuvent casser instantanément. Pendant des années, ce fut l’une des fonctionnalités les plus demandées par la communauté Directus — sans solution intégrée, et sans extension fiable disponible.

Nous avons rencontré exactement ce problème sur presque tous les projets livrés à nos clients. Nous avons donc construit une solution et l’avons publiée en open source, gratuitement, pour tout le monde.

Le problème : Directus n’a pas de renommage sécurisé

Lorsque vous renommez une collection ou un champ dans Directus, le système crée une nouvelle table ou une nouvelle colonne et laisse l’ancienne en place. Toutes vos clés étrangères, vos points d’API personnalisés, vos réglages d’affichage et les fonctionnalités qui en dépendent se retrouvent cassés. Corriger ces références à la main est source d’erreurs et chronophage — surtout sur de grandes bases de données comptant des dizaines de collections interconnectées.

Découvrez l’extension Directus Safe Rename

Notre extension directus-extension-safe-rename est une extension Directus open source et gratuite qui permet de renommer collections et champs en toute sécurité. Elle prend automatiquement en charge les références internes, la mise à jour des relations et la correspondance des permissions.

Ce qu’elle fait

L’extension garantit que, lorsque vous renommez une collection ou un champ :

• toutes les clés étrangères sont mises à jour vers le nouveau nom ;
• les permissions et les politiques sont conservées ;
• les points d’API personnalisés et les automatisations continuent de fonctionner ;
• les données existantes sont migrées en toute sécurité, sans aucune perte ;
• les collections système et les champs critiques sont protégés contre les renommages accidentels.

Pourquoi nous l’avons construite

Nous construisons des solutions sur mesure basées sur Directus pour des clients dans toute l’Europe. À mesure que nos projets se complexifiaient, l’absence de renommage sécurisé est devenue un véritable goulot d’étranglement. Imaginez renommer une collection dans un système en production dont plus de 50 tables dépendent : mettre à jour chaque référence à la main n’est pas seulement long, c’est dangereux.

Nous avons parcouru les tickets GitHub de Directus, les forums de la communauté et Discord. C’était l’une des fonctionnalités les plus demandées. Nous avons donc décidé de la traiter correctement et de rendre la solution à la communauté.

Installation

L’extension s’installe comme n’importe quelle autre extension Directus :

npm install directus-extension-safe-rename

Redémarrez ensuite votre instance Directus. L’extension apparaît dans l’interface d’administration sous Extensions, et la fonction de renommage devient accessible depuis les réglages des collections et des champs.

Les instructions d’installation complètes, des exemples d’utilisation et des captures d’écran se trouvent sur le dépôt GitHub.

À qui s’adresse-t-elle ?

À tout développeur, agence ou équipe Directus qui a déjà renoncé à renommer une collection de peur de tout casser en aval. Si vous maintenez des installations complexes à plusieurs collections où le renommage est risqué, cette extension est faite pour vous.

Contribuer

L’extension est sous licence MIT et ouverte aux contributions. Que vous soyez un utilisateur aguerri de Directus ou que vous débutiez, votre apport — signalements de bugs, demandes de fonctionnalités ou pull requests — aide à l’améliorer pour tout le monde.

• GitHub : github.com/contensu/directus-extension-safe-rename
• npm : directus-extension-safe-rename
• Licence : MIT

À propos de Contensu

Nous sommes une agence de développement de logiciels sur mesure qui construit des CRM, des sites web, des outils internes et des plateformes e-learning pour des PME dans toute l’Europe. Nous concevons et maintenons également des outils open source qui résolvent de vrais problèmes rencontrés dans notre travail quotidien.

Si vous avez besoin d’un logiciel sur mesure, écrivez-nous.