Migration de Drupal 7 vers Drupal 11 : Guide technique complet

Contrairement aux mises à niveau précédentes de Drupal, passer de la version 7 à 11 implique de migrer vers une base architecturale entièrement différente. En travaillant avec nos clients à travers ces migrations, nous avons appris que le succès dépend d'une préparation approfondie et de la compréhension des complexités techniques impliquées.

Ce guide fournit la feuille de route pratique dont vous avez besoin pour exécuter une migration réussie de Drupal 7 vers 11, de l'évaluation initiale à l'optimisation post-lancement.

Comprendre le paysage de la migration

Pourquoi ce n'est pas qu'une mise à niveau

La transition de Drupal 7 à 11 représente un changement architectural fondamental. Drupal 8 a introduit les composants Symfony, la programmation orientée objet et le système de gabarits Twig—des changements qui rendent les mises à niveau directes impossibles. Au lieu de cela, vous effectuez une migration qui implique :

• Reconstruire la structure de votre site sur Drupal 11
• Migrer le contenu et les données de configuration
• Réécrire les modules et thèmes personnalisés
• Mettre à jour les intégrations et flux de travail

Avantages techniques de Drupal 11

Drupal 11 introduit plusieurs améliorations techniques convaincantes :

Améliorations de performance : Construit sur Symfony 7 et PHP 8.3, Drupal 11 offre une exécution plus rapide et une meilleure gestion de la mémoire. Le nouveau système de cache fournit des gains de performance significatifs pour les sites à fort trafic.

Améliorations de sécurité : Des mises à jour de sécurité régulières, des systèmes d'authentification améliorés et une meilleure protection contre les vulnérabilités courantes rendent Drupal 11 significativement plus sécurisé que les versions héritées.

Expérience éditoriale : Le nouveau thème administratif Claro et CKEditor 5 fournissent une expérience d'édition de contenu plus intuitive, réduisant le temps de formation pour les équipes éditoriales.

Expérience de développement : Les composants de répertoire unique, les API améliorées et de meilleurs outils de débogage rendent le développement plus efficace et maintenable.

Évaluation pré-migration et planification

Audit des exigences techniques

Avant de commencer votre migration, vérifiez que votre infrastructure répond aux exigences de Drupal 11 :

Exigences serveur :

• PHP 8.3 avec extension zlib
• MySQL 8.0 ou MariaDB 10.6
• Apache 2.4.7 (IIS n'est plus pris en charge)
• Composer 2.7.7
• Drush 13

Inventaire du contenu et du code :

Créez un inventaire complet de votre site actuel incluant :

• Tous les types de contenu et champs personnalisés
• Rôles utilisateur et permissions
• Modules contributifs et personnalisés
• Personnalisations de thème
• Intégrations tierces
• Tables ou structures de base de données personnalisées

Évaluation de la compatibilité des modules

Notre équipe recommande d'utiliser le module Upgrade Status pour évaluer la préparation de votre site actuel à la migration :

drush en upgrade_status
drush upgrade_status:analyze

Cette analyse révèle quels modules ont des équivalents Drupal 11 et identifie le code personnalisé nécessitant des mises à jour. Basé sur des projets clients, attendez-vous à ce qu'environ 70-80% des modules contributifs aient des équivalents directs ou des alternatives appropriées.

Stratégie de contenu et nettoyage

Les projets de migration fournissent une excellente opportunité pour nettoyer votre architecture de contenu. Nous aidons les clients à identifier :

• Les types de contenu obsolètes qui peuvent être consolidés
• Les champs et taxonomies inutilisés
• Les fichiers et médias orphelins
• Les comptes utilisateur et rôles redondants

Ce nettoyage réduit la complexité de migration et améliore les performances de votre nouveau site.

Configuration de votre environnement de migration

Préparation de l'environnement

Commencez par créer un environnement de migration dédié qui reflète votre configuration de production :

# Créer un nouveau site Drupal 11
composer create-project drupal/recommended-project drupal11_migration
cd drupal11_migration

# Installer les modules de migration requis
composer require drupal/migrate_plus drupal/migrate_tools
drush en migrate migrate_drupal migrate_drupal_ui migrate_plus migrate_tools

Configuration d'accès à la base de données

Assurez-vous que votre environnement Drupal 11 peut accéder à votre base de données Drupal 7. Cela implique typiquement :

• Créer un utilisateur de base de données en lecture seule pour la base de données D7
• Configurer l'accès réseau entre les environnements
• Tester la connectivité avant de procéder

# Tester la connexion à la base de données
drush sql-query --database=migrate "SELECT COUNT(*) FROM users" --legacy-db-url=mysql://user:pass@host/d7db

Exécution de la migration

Migration du contenu principal

Le processus de migration implique plusieurs phases distinctes. Notre approche suit typiquement cette séquence :

Phase 1 : Migration de structure

# Migrer les utilisateurs et rôles en premier
drush migrate:import upgrade_d7_user_role
drush migrate:import upgrade_d7_user

# Migrer la taxonomie
drush migrate:import upgrade_d7_taxonomy_vocabulary
drush migrate:import upgrade_d7_taxonomy_term

# Migrer les types de contenu et champs
drush migrate:import upgrade_d7_node_type
drush migrate:import upgrade_d7_field

Phase 2 : Migration de contenu

# Migrer les nœuds par type de contenu
drush migrate:import upgrade_d7_node:article
drush migrate:import upgrade_d7_node:page
drush migrate:import upgrade_d7_node:custom_type

# Migrer les commentaires et autre contenu
drush migrate:import upgrade_d7_comment
drush migrate:import upgrade_d7_menu_links

Phase 3 : Fichiers et médias

# Migrer les fichiers et médias
drush migrate:import upgrade_d7_file
drush migrate:import upgrade_d7_file_entity

Gestion des migrations complexes

Pour les sites avec des structures de données complexes, vous pourriez avoir besoin de plugins de migration personnalisés. Voici un exemple de configuration de migration personnalisée :

# Migration personnalisée pour données de champ complexes
id: custom_field_migration
label: Migration de champ personnalisé
migration_group: migrate_drupal_7
source:
  plugin: d7_database
  query:
    - SELECT nid, field_custom_data_value, field_custom_data_format
    - FROM field_data_field_custom_data
    - WHERE bundle = 'custom_content_type'
process:
  nid: nid
  field_processed_data:
    plugin: callback
    callable: custom_data_processor
    source: field_custom_data_value
destination:
  plugin: entity:node
  default_bundle: custom_content_type

Gestion de l'état de migration

Surveillez votre progression de migration en utilisant ces commandes essentielles :

# Vérifier le statut de migration
drush migrate:status --group=migrate_drupal_7

# Afficher des informations détaillées de migration
drush migrate:messages upgrade_d7_node

# Annuler une migration spécifique si nécessaire
drush migrate:rollback upgrade_d7_node

# Réinitialiser le statut de migration
drush migrate:reset-status upgrade_d7_node

Migration de code personnalisé

Mises à jour de développement de modules

Les modules personnalisés nécessitent des mises à jour significatives pour la compatibilité Drupal 11. Les changements clés incluent :

Mises à jour du système de hooks : Plusieurs hooks ont été remplacés par des abonnés d'événements ou des services.

// Approche Drupal 7
function mymodule_node_insert($node) {
  // Logique personnalisée
}

// Approche Drupal 11
class MyModuleEventSubscriber implements EventSubscriberInterface {
  public function onNodeInsert(EntityInsertEvent $event) {
    // Logique personnalisée
  }
}

Changements de l'API de base de données : Les requêtes directes de base de données doivent être mises à jour pour utiliser la nouvelle API de base de données.

// Drupal 7
$result = db_query("SELECT nid FROM {node} WHERE type = :type", array(':type' => 'article'));

// Drupal 11
$query = \Drupal::database()->select('node_field_data', 'n');
$query->fields('n', ['nid']);
$query->condition('n.type', 'article');
$result = $query->execute();

Migration de thème

Les thèmes Drupal 7 sont incompatibles avec Drupal 11 et doivent être reconstruits en utilisant les gabarits Twig. Notre équipe approche typiquement la migration de thème en :

• Analysant les fichiers de gabarit existants et identifiant les composants clés
• Créant de nouveaux gabarits Twig qui correspondent au design désiré
• Implémentant des améliorations de design adaptatif
• Optimisant pour la performance et l'accessibilité

{# Exemple de gabarit Twig Drupal 11 #}

  {% if display_submitted %}