Mise à jour vers Drupal 10

Lecture de 2 minutes

Voici des instructions sommaires de mise à jour de Drupal 9 vers Drupal 10.

Exécuter les commandes composer suivantes

composer update
composer require 'drupal/stable:^2.0'
composer require 'drupal/classy:^1.0'
composer require 'drupal/color:^1.0'

Passer à CKEditor 5

  • Activer le module CKEditor 5
  • Dans les formats de texte, sélectionner CKEditor 5 plutôt que CKEditor 4

Plus d'informations ici.

Désactiver les modules exclus de Drupal 10

Dans la page de gestion des extensions, désinistaler les modules suivants :

  • RDF
  • CKEditor

Désactiver les thèmes exclus de Drupal 10

Dans la page d'apparence, désinistaler le thème suivant :

  • Seven

Modifier le theme du site.

Dans le fichier .theme du site, remplacer la ligne :

core_version_requirement: ^8 || ^9

par ces lignes :

core_version_requirement: ^8 || ^9 || ^10

dependencies:
  - classy:classy

Mettre à jour le fichier gitignore

Ajouter la ligne suivante sous /web/modules/contrib/ :

/web/themes/contrib/

Utiliser le module upgrade_status pour régler les conflits

Activer le module upgrade_status et rendez-vous à /admin/reports/upgrade-status pour résoudre les problèmes.

composer require drupal/upgrade_status

Une fois compléter désinstaller et supprimez le module :

composer remove drupal/upgrade_status

Mettre à jour le fichiers composer.json

Mettre à jour la version de Drupal

"drupal/core-composer-scaffold": "^10",
"drupal/core-project-message": "^10",
"drupal/core-recommended": "^10",

et un peu plus bas :

"drupal/core-dev": "^10",

Mettre à jour la version de kint

"kint-php/kint": "^5.0"

Mettre à jour Drupal

Exécuter la commande suivante :

composer update

Si tous les modules présents sur le sites sont compatibles, le site sera mis à jour vers Drupal 10.

Mise à jour de la base de donnée

Il faut exécuter les mises à jour de base de données dans Drupal pour que le site fonctionne correctement. Rendez-vous au /update.php pour lancer les mises à jour.

Au besoin, activer le paramètre suivant dans settings.php si vous ne parvenez pas à accéder à la page de mise à jour :

$settings['update_free_access'] = TRUE;

Mise à jour additionnelles manuelles

Les fichiers suivants ont été mis à jour et leur changements doivent être intégrés manuellement.

  • .htaccess
  • robots.txt

Articles supplémentaires

Cet article explique aussi comment installer des modules qui ne sont pas encore prêts pour Drupal 10 : How to upgrade Drupal 9 to 10 - Goran Nikolovski