Drupal est un CMS flexible, qui ne cesse d’évoluer pour répondre aux évolutions technologiques du marché. Pour ce faire, le CMS sort, chaque année, une nouvelle version majeure, qui apporte son lot de nouveautés et d’innovation.

Il est intéressant de noter qu’à ce jour, Drupal supporte 3 versions stables : Drupal 7, 10 et 11. Néanmoins, la version 7 de Drupal devrait prendre fin en janvier 2025. C’est pourquoi, il est impératif de migrer son site vers Drupal 10 ou Drupal 11 afin de ne pas avoir de rupture technologique au moment où Drupal 7 prendra fin. 

Dans cet article, un de nos experts vous explique ainsi comment migrer son site Drupal 7 vers Drupal 10. 

Prérequis et préparation

Tout d’abord, cette montée en version nécessite quelques prérequis. En effet, la version 7 de Drupal étant une version antérieure, certains modules et autres types de configuration ne peuvent être compatibles avec les versions récentes, à savoir Drupal 10 et 11. 

C’est pourquoi, il convient d’identifier en premier lieu les contenus et les fonctionnalités à migrer (Types de contenu, champs personnalisés, taxonomies, vues, utilisateurs, permissions, URL et fichiers).

À la suite de cela, une analyse des modules est nécessaire. Ici, nous allons donc identifier les modules contrib indispensables et leur équivalent Drupal 10. Un listing des modules custom devra aussi être fait, afin de savoir lesquels devront être adaptés pour rendre compatible les fonctionnalités Drupal 7 en Drupal 10.

Une fois le tour d’horizon effectué, vous pouvez alors commencer par créer un Drupal vierge, en utilisant la dernière version disponible de Drupal.

Un back-up de la base de données de Drupal 7 devra également être effectué.

Préparation du site Drupal 10

 En ce qui concerne la configuration des modules et du thème de votre site internet, il est impératif :

• D’installer et de configurer tous les modules nécessaires, y compris les nouveaux modules pour remplacer ceux de Drupal 7 qui n'existent plus en Drupal 10. 
• D'adapter les thèmes pour Drupal 10 (convertissez le thème personnalisé ou créez-en un nouveau basé sur le thème de base recommandé comme Olivero). 

Ces étapes vous permettent ainsi de préparer votre site pour effectuer la montée en version de votre site Drupal. 

Ci-dessous, vous trouverez le processus et la méthodologie à appliquer pour la migration de vos données.

Migration des données 

Configurer le settings.php

Configurez la connexion à la base de données source (Drupal 7) et à la base de données cible (Drupal 10) si les deux bases de données se trouvent sur le même serveur.

Base de données cible (Drupal 10)

$databases['default']['default'] = array ( 
'database' => 'base_donne_d10', 
'username' => 'user', 
'password' => 'password', 
'prefix' => '',
'host' => 'db',
'port' => '3306', 
'namespace' => 'Drupal\\mysql\\Driver\\Database\\mysql', 
'driver' => 'mysql', 
'autoload' => 'core/modules/mysql/src/Driver/Database/mysql/', 
);

Base de données source (Drupal 7) 

Ajoutez une connexion secondaire pour accéder à la base de données Drupal 7 :

$databases['migrate']['default'] = array ( 
'database' => 'base_donne_d7', 
'username' => ‘user’, 
'password' => 'password', 
'prefix' => '', 
'host' => 'db', 
'port' => '3306', 
'namespace' => 'Drupal\\Core\\Database\\Driver\\mysql', 
'driver' => 'mysql', 
);

 Configuration du Module de Migration 

• Installez les modules de migration requis dans Drupal 10 via Composer :

composer require drupal/migrate_drupal drupal/migrate_drupal_ui drupal/migrate_plus drupal/migrate_tools 

Exécution de la Migration: 

Lancement de Drush pour Migration : Utilisez Drush pour lancer les commandes de migration de Drupal 7 vers Drupal 10 : 

drush migrate:upgrade --configure-only 

Cette commande génère automatiquement les configurations de migration basées sur les types de contenu, taxonomies, fichiers et utilisateurs de Drupal 7. 

Accéder à l'interface de migration dans le BO : 

• Connectez-vous à votre Drupal 10 en tant qu'administrateur. 
• Allez dans Structure > Migration.

Image

 Lancer la migration : 

• Sur la page de migration, vous verrez une liste des éléments que vous pouvez migrer depuis Drupal 7, comme les utilisateurs, les types de contenu, les nœuds, les taxonomies, etc.

  Image

  
• Vous pouvez lancer chaque migration individuellement ou sélectionner toutes les migrations disponibles. 

Il est impératif de suivre l’ordre suivant pour le lancement des migrations depuis le back-office. 

• Rôles et permissions : configuration des rôles et permissions utilisateurs. 
• Utilisateurs : migration des comptes utilisateurs sans les contenus associés. 
• Fichiers et images : migration des fichiers et images téléchargés, associés aux nœuds. 
• Taxonomies : migration des vocabulaires et des termes de taxonomie pour organiser les contenus. 
• Types de contenu : structures de contenu comme les types de pages, articles, etc., sans les nœuds eux-mêmes. 
• Blocs personnalisés : contenu personnalisé des blocs et configurations de base. 
• Menus : migration des menus de navigation et leurs liens.
• Contenus (nœuds) : migration des nœuds (articles, pages, etc.) qui utilisent les types de contenu.
• Commentaires : si les commentaires sont activés, migration des commentaires associés aux nœuds.
• Vues : migration des vues personnalisées pour présenter les contenus.

- Une fois la migration terminée, il faut vérifier les données dans chaque section pour s’assurer que les contenus, utilisateurs, taxonomies, etc., ont bien été migrés.

Étape finale : Confirmation et correction des problèmes 

Etape 1 : Vérification globale dans le BO Rendez-vous dans la section Messages après chaque migration pour examiner les erreurs ou avertissements.

Image

Etape 2 : Validation manuelle post-migration 

• Vérifier chaque section migrée (utilisateurs, taxonomies, contenus, etc.) pour confirmer que les données sont complètes. 
• Effectuez des tests fonctionnels sur les rôles, menus, vues, et affichages des contenus. 

Vous avez donc à présent toute la procédure à suivre pour pouvoir migrer votre site Drupal 7 vers Drupal 10. Néanmoins, si vous souhaitez être accompagnée dans cette montée en version, notre agence Drupal peut vous proposer ses services. Pour ce faire, n’hésitez pas à nous faire une demande de devis dans notre formulaire de contact.