DocumentationCommerceGuide de mise à niveau

[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Effectuer une mise à niveau

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Expérimenté
  • Administration
  • Développeur

Vous pouvez mettre à niveau sur site les déploiements de l’application Adobe Commerce à partir de la ligne de commande si vous avez installé le logiciel :

  • Téléchargement du métapaquet du compositeur à l’aide de la commande composer create-project.
  • Installation de l’archive compressée.
NOTE

Les instructions suivantes vous montrent comment effectuer une mise à niveau à l’aide du gestionnaire de packages du compositeur. Adobe Commerce 2.4.2 a introduit la prise en charge du compositeur 2. Si vous tentez d’effectuer une mise à niveau à partir de la version <2.4.1, vous devez d’abord effectuer la mise à niveau vers une version compatible avec le compositeur 2 (par exemple, 2.4.2) à l’aide du compositeur 1 avant d’effectuer la mise à niveau vers le compositeur 2 pour les mises à niveau >2.4.2. En outre, vous devez exécuter une version prise en charge de PHP.

WARNING
La procédure de mise à niveau d’Adobe Commerce a été modifiée. Vous devez installer une nouvelle version du package magento/composer-root-update-plugin (voir conditions préalables). En outre, les commandes de mise à niveau sont passées de composer require magento/<package_name> à composer require-commerce magento/<package_name>.

Avant de commencer

Vous devez remplir les conditions préalables à la mise à niveaupour préparer votre environnement avant de démarrer le processus de mise à niveau.

Gestion des packages

NOTE
Consultez les exemples à la fin de cette section pour obtenir de l’aide sur la spécification de différents niveaux de version. Par exemple, les correctifs de qualité et les correctifs de sécurité. Si ces packages sont introuvables dans le compositeur, contactez l’assistance Adobe Commerce.

  1. Passez en mode de maintenance pour empêcher l’accès à votre boutique pendant le processus de mise à niveau.

    code language-bash 
    bin/magento maintenance:enable

    Voir Activation ou désactivation du mode de maintenance pour d’autres options. Vous pouvez éventuellement créer une page mode de maintenance personnalisé.

  2. Le démarrage du processus de mise à niveau pendant l’exécution de processus asynchrones, tels que les consommateurs de file d’attente de messages, peut entraîner la corruption des données. Pour éviter la corruption des données, désactivez toutes les tâches cron.

    Adobe Commerce sur les infrastructures cloud :

    code language-bash 
    ./vendor/bin/ece-tools cron:disable

    Magento Open Source :

    code language-bash 
    bin/magento cron:remove

  3. Démarrez manuellement tous les consommateurs de file d'attente de messages pour vous assurer que tous les messages sont consommés.

    code language-bash 
    bin/magento cron:run --group=consumers

    Attendez que la tâche cron soit terminée. Vous pouvez surveiller le statut de la tâche à l’aide d’une visionneuse de processus ou en exécutant plusieurs fois la commande ps aux | grep 'bin/magento queue' jusqu’à ce que tous les processus soient terminés.

  4. Créez une sauvegarde du fichier composer.json.

    code language-bash 
    cp composer.json composer.json.bak

  5. Ajoutez ou supprimez des packages spécifiques en fonction de vos besoins.

    Par exemple, si vous effectuez une mise à niveau de Magento Open Source vers Adobe Commerce, supprimez le package Magento Open Source.

    code language-bash 
    composer remove magento/product-community-edition --no-update

    Vous pouvez également mettre à niveau les exemples de données.

    code language-bash 
    composer require <sample data module-1>:<version> ... <sample data module-n>:<version> --no-update

    • Adobe Commerce :

      code language-bash 
      composer require magento/module-bundle-sample-data:100.4.* magento/module-widget-sample-data:100.4.* magento/module-theme-sample-data:100.4.* magento/module-catalog-sample-data:100.4.* magento/module-customer-sample-data:100.4.* magento/module-cms-sample-data:100.4.*  magento/module-catalog-rule-sample-data:100.4.* magento/module-sales-rule-sample-data:100.4.* magento/module-review-sample-data:100.4.* magento/module-tax-sample-data:100.4.* magento/module-sales-sample-data:100.4.* magento/module-grouped-product-sample-data:100.4.* magento/module-downloadable-sample-data:100.4.* magento/module-msrp-sample-data:100.4.* magento/module-configurable-sample-data:100.4.* magento/module-product-links-sample-data:100.4.* magento/module-wishlist-sample-data:100.4.* magento/module-swatches-sample-data:100.4.* magento/sample-data-media:100.4.* magento/module-offline-shipping-sample-data:100.4.* magento/module-gift-card-sample-data:100.4.* magento/module-customer-balance-sample-data:100.4.* magento/module-target-rule-sample-data:100.4.* magento/module-gift-registry-sample-data:100.4.* magento/module-multiple-wishlist-sample-data:100.4.* --no-update

    • Magento Open Source :

      code language-bash 
      composer require magento/module-bundle-sample-data:100.4.* magento/module-widget-sample-data:100.4.* magento/module-theme-sample-data:100.4.* magento/module-catalog-sample-data:100.4.* magento/module-customer-sample-data:100.4.* magento/module-cms-sample-data:100.4.*  magento/module-catalog-rule-sample-data:100.4.* magento/module-sales-rule-sample-data:100.4.* magento/module-review-sample-data:100.4.* magento/module-tax-sample-data:100.4.* magento/module-sales-sample-data:100.4.* magento/module-grouped-product-sample-data:100.4.* magento/module-downloadable-sample-data:100.4.* magento/module-msrp-sample-data:100.4.* magento/module-configurable-sample-data:100.4.* magento/module-product-links-sample-data:100.4.* magento/module-wishlist-sample-data:100.4.* magento/module-swatches-sample-data:100.4.* magento/sample-data-media:100.4.* magento/module-offline-shipping-sample-data:100.4.* --no-update

  6. Mettez à niveau votre instance en utilisant la syntaxe de commande composer require-commerce suivante :

    code language-bash 
    composer require-commerce magento/<product> <version> --no-update [--interactive-root-conflicts] [--force-root-updates] [--help]

    Les options de commande incluent :

    • <product> — (Obligatoire) Package à mettre à niveau. Pour les installations sur site, cette valeur doit être soit product-community-edition soit product-enterprise-edition.

    • <version> — (Obligatoire) Version d’Adobe Commerce vers laquelle vous effectuez la mise à niveau. Par exemple, 2.4.3.

    • --no-update — (Obligatoire) Désactive la mise à jour automatique des dépendances.

    • --interactive-root-conflicts — (Facultatif) Permet d'afficher et de mettre à jour de manière interactive toutes les valeurs obsolètes des versions précédentes ou toutes les valeurs personnalisées qui ne correspondent pas à la version vers laquelle vous effectuez la mise à niveau.

    • --force-root-updates — (Facultatif) Remplace toutes les valeurs personnalisées en conflit avec les valeurs Commerce attendues.

    • --help — (Facultatif) Fournit des détails d’utilisation sur le plug-in.

    Si ni --interactive-root-conflicts ni --force-root-updates ne sont spécifiés, la commande conserve les valeurs existantes en conflit et affiche un message d’avertissement. Pour en savoir plus sur le plug-in, consultez le fichier Lisez-moi sur l’utilisation du plug-in.

  7. Mettez à jour les dépendances.

    code language-bash 
    composer update

Exemple - Liste des versions disponibles

Pour afficher la liste complète des versions 2.4.x disponibles :

Magento Open Source:

composer show magento/product-community-edition 2.4.* --available | grep -m 1 versions

Adobe Commerce:

composer show magento/product-enterprise-edition 2.4.* --available | grep -m 1 versions

Exemple - Correctif de qualité

Les correctifs de qualité contiennent principalement des correctifs de sécurité et fonctionnels. Cependant, ils peuvent parfois contenir de nouvelles fonctionnalités rétrocompatibles. Utilisez le compositeur pour télécharger un correctif de qualité.

Adobe Commerce:

composer require-commerce magento/product-enterprise-edition 2.4.6 --no-update

Magento Open Source:

composer require-commerce magento/product-community-edition 2.4.6 --no-update

Exemple - Correctif de sécurité

Les correctifs de sécurité contiennent uniquement des correctifs de sécurité. Ils sont conçus pour accélérer et faciliter le processus de mise à niveau. Les correctifs de sécurité utilisent la 2.4.x-px de convention de nommage du compositeur.

Adobe Commerce:

composer require-commerce magento/product-enterprise-edition 2.4.6-p3 --no-update

Magento Open Source:

composer require-commerce magento/product-community-edition 2.4.6-p3 --no-update

Mettre à jour les métadonnées

  1. Mettez à jour les champs "name", "version" et "description" du fichier composer.json selon vos besoins.

    note note
    NOTE
    La mise à jour des métadonnées dans le fichier composer.json est entièrement superficielle et non fonctionnelle.

  2. Appliquez les mises à jour.

    code language-bash 
    composer update

  3. Effacez les sous-répertoires var/ et generated/ :

    code language-bash 
    rm -rf var/cache/*
    code language-bash 
    rm -rf var/page_cache/*
    code language-bash 
    rm -rf generated/code/*
    note note
    NOTE
    Si vous utilisez un stockage du cache autre que le système de fichiers, tel que Redis ou Memcached, vous devez également effacer manuellement le cache.

  4. Mettez à jour le schéma et les données de la base de données.

    code language-bash 
    bin/magento setup:upgrade

  5. Désactivez le mode de maintenance.

    code language-bash 
    bin/magento maintenance:disable

  6. (Facultatif) Redémarrez Le Vernis.

    Si vous utilisez un vernis pour la mise en cache de page, redémarrez-le :

    code language-bash 
    service varnish restart

Vérifier votre travail

Pour vérifier si la mise à niveau a réussi, ouvrez l’URL de votre storefront dans un navigateur web. Si votre mise à niveau a échoué, votre storefront ne se charge pas correctement.

Si l’application échoue avec une erreur We're sorry, an error has occurred while generating this email. :

  1. Réinitialisez propriété et autorisations du système de fichiers en tant qu’utilisateur disposant de droits d’root.

  2. Effacez les répertoires suivants :

    • var/cache/
    • var/page_cache/
    • generated/code/

  3. Vérifiez à nouveau votre storefront dans votre navigateur web.

recommendation-more-help
83a60e0e-8849-4685-a8cd-c129ecd795ea