Problèmes après une mise à jour.

Learn DXPR BuilderManage the siteEen probleem oplossen

Terminez une mise à jour qui a mal tourné. Dans presque tous les cas, le code a été mis à jour mais pas la base de données, une vieille copie du module gêne, ou une dépendance manque.

Lancer la mise à jour dans le bon ordre

  1. Sauvegardez la base de données.
  2. Lancez composer require drupal/dxpr_builder, avec une contrainte de version si vous figez les versions.
  3. Lancez drush updb -y (ou visitez /update.php).
  4. Lancez drush cr.
  5. Ouvrez une page du builder et enregistrez-la à nouveau.

Important : ne désinstallez jamais le module pour le mettre à jour. La désinstallation supprime modèles enregistrés, profils et réglages.

Composer affiche une erreur

  • « Could not find a version of package drupal/dxpr_builder matching your minimum-stability ». La 3.x est publiée en versions bêta. Autorisez-les dans la contrainte : composer require 'drupal/dxpr_builder:^3.0@beta'.
  • « Could not find a matching version of package dxpr/dxpr_builder ». Le paquet sur drupal.org est drupal/dxpr_builder. Remplacez dxpr/dxpr_builder par drupal/dxpr_builder dans composer.json, puis lancez composer update drupal/dxpr_builder.
  • Composer refuse car le dossier n’est pas géré par Composer. Une copie a été téléversée à la main. Supprimez modules/contrib/dxpr_builder et relancez la commande require.
  • « Disk quota exceeded » ou « write failed ». Libérez de l’espace disque sur le serveur avant de réessayer.

La mise à jour de la base de données échoue

  • « Unable to install modules key due to missing modules key ». La 3.x a besoin du module Key, et la mise à jour 9020 l’installe. Son code manque car le module n’a pas été installé avec Composer. Lancez composer require drupal/key, puis à nouveau drush updb -y.
  • Un hook de mise à jour nommé échoue. Lancez drush updb -vvv et joignez l’erreur complète à votre ticket.
  • « module 'dxpr_builder_page' is missing its dependency module field_group ». Le sous-module DXPR Builder Drag and Drop Page a besoin de Field Group. Lancez composer require drupal/field_group, puis drush en dxpr_builder_page -y.

Les pages semblent cassées après la mise à jour

Certaines versions convertissent l’ancien balisage, comme les carrousels Owl et les compteurs circulaires, par lots pendant drush updb. Les éléments qui échouent restent en attente.

  1. Accédez à DXPR Studio > DXPR Builder > Content items > Migrations (/admin/dxpr_studio/dxpr_builder/migration-status).
  2. Si une migration affiche Pending, cliquez sur Run now, ou Run all pending migrations.
  3. Vérifiez Reports > Recent log messages pour les éléments qu’un lot a sautés.

Composer refuse une mise à jour majeure du cœur de Drupal

DXPR Builder 3.x prend en charge Drupal 10.2 et ultérieur, et Drupal 11.

  1. Vérifiez les notes de version de DXPR Builder, DXPR Theme et DXPR Theme Helper pour la version qui prend en charge la nouvelle majeure.
  2. Lancez Upgrade Status pour voir quels paquets ne sont pas prêts.
  3. Figez la majeure du cœur dans composer.json. Un composer require drupal/core-recommended sans contrainte peut tirer la prochaine majeure par accident.

L’éditeur a cassé juste après la mise à jour

Suivez L’éditeur n’apparaît pas. Les causes principales y sont celles qui suivent une mise à jour partielle : mises à jour de base en attente, fichiers périmés, et cache d’agrégation construit depuis l’ancienne version.

Je migre depuis Glazed Builder

DXPR Builder 3.x ne convertit plus les noms de classes Glazed dans le contenu stocké. Mettez d’abord à jour vers la dernière version 2.x et lancez ses mises à jour de base de données, puis passez en 3.x. Voir Migrer depuis DXPR Builder 1.x ou 2.x.

Vérifier la correction

drush updb ne signale aucune mise à jour en attente, drush pm:list --filter=dxpr affiche les versions voulues, et une page du builder réenregistrée s’affiche pareil dans l’éditeur et pour un visiteur.

Et ensuite ?

Mettre à jour DXPR Builder pour la procédure de mise à jour de routine.