[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."}

Utilisation

Last update: Thu Jun 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Configuration

Créé pour :

Expérimenté
Administration
Développeur

Le Quality Patches Tool fournit des correctifs individuels développés par Adobe et la communauté Magento Open Source. Il vous permet d’appliquer, d’annuler et d’afficher des informations générales sur tous les correctifs individuels disponibles pour la version installée d’Adobe Commerce. Vous pouvez appliquer des correctifs à des projets Adobe Commerce, quelle que soit la personne qui les a développés. Par exemple, vous pouvez appliquer un correctif développé par la communauté aux projets Adobe Commerce.

Regardez cette vidéo technique et découvrez comment utiliser l’outil de correctifs de qualité pour Adobe Commerce.

INFO

Voir Application de correctifs individuelspour obtenir des instructions sur l’application de correctifs à vos projets Adobe Commerce. Voir Quality Patches Tool : Rechercher des correctifs pour consulter la liste complète des correctifs publiés.

WARNING

Il n’est pas recommandé d’utiliser le Quality Patches Tool pour appliquer un grand nombre de correctifs, car cela augmente la complexité de votre code et rend la mise à niveau vers une nouvelle version plus difficile.

Installer

INFO

S’il n’est pas déjà installé, vous devez installer Git ou Patch avant d’installer le Quality Patches Tool. Ajoutez le package magento/quality-patches Composer à votre fichier composer.json :

composer require magento/quality-patches

Affichage des correctifs individuels

Pour afficher la liste des correctifs individuels disponibles pour votre version d’Adobe Commerce :

./vendor/bin/magento-patches status

Une sortie similaire à celle-ci s’affiche :

Titre

Type

Statut

Détails

MAGECLOUD-5069

FPC est désactivé pendant les déploiements

Facultatif

Non appliqué

Composants affectés :
- magento/module-page-cache

MCLOUD-5650

Conserver la configuration de déploiement après lecture du fichier

Facultatif

Non appliqué

Composants concernés :
- Magento/framework

MCLOUD-5684

La pagination ne fonctionne pas - product_list_limit=all

Facultatif

Non appliqué

Composants concernés : - Magento/module-elasticsearch

MCLOUD-5837

Correction du problème de répartition de charge

Obsolète

Appliqué

Remplacement recommandé : MC-1
Composants affectés : - magento/framework

BUNDLE-2554

Définir le bug des informations de paiement

Facultatif

Non appliqué

Composants concernés :
- amzn/amazon-pay-module

MC-1

Correction du problème 1

Facultatif

Appliqué

Composants concernés :
- magento/module-cms

MC-2

Correction du problème 2

Facultatif

Non appliqué

Composants concernés :
- magento/module-cms

MC-3

Correction du problème 3.

Facultatif

Non appliqué

Correctifs requis :
- MC-2
Composants concernés :
- magento/module-cms

MC-3-V2

Mise à jour du correctif pour le problème 3, remplace le correctif MC-3

Facultatif

S.O.

Composants concernés :
-magento/module-cms

Adobe Commerce 2.3.5.

Le tableau de statut comprend les éléments suivants :

Type :
- Optional — Tous les correctifs du Quality Patches Tool et du package Guide de Commerce sur les infrastructures cloud > Appliquer des correctifs sont facultatifs pour les installations Adobe Commerce.
- Deprecated — Adobe a rendu obsolète le correctif individuel. Si vous avez appliqué le correctif, nous vous recommandons de le rétablir. L’opération de rétablissement supprime également le correctif de la table des statuts.
Statut :
- Applied — Le correctif a été appliqué.
- Not applied — Le correctif n'a pas été appliqué.
- N/A — Impossible de définir l'état du correctif en raison de conflits.
Détails :
- Affected components — Liste des modules concernés.
- Required patches : liste des patchs à appliquer pour qu'un patch indiqué fonctionne correctement (dépendances).
- Recommended replacement — Correctif qui est un remplacement recommandé pour un correctif obsolète.

INFO

Après la mise à niveau vers une nouvelle version d’Adobe Commerce, vous devez réappliquer les correctifs si ceux-ci ne sont pas inclus dans la nouvelle version. Voir Réappliquer les correctifs après une mise à niveau.

Application de correctifs individuels apply-individual-patches

WARNING

Il est recommandé de tester tous les correctifs dans un environnement d’évaluation ou de développement avant de les déployer en production. Il est également recommandé de sauvegarder vos données avant d’appliquer un correctif. Voir Sauvegarde et restauration du système de fichiers, du support et de la base de données.

Pour appliquer un seul correctif, exécutez la commande suivante où MAGETWO-XXXX correspond à l’identifiant de correctif spécifié dans le tableau d’état :

./vendor/bin/magento-patches apply MAGETWO-XXXX

Vous pouvez également appliquer plusieurs correctifs en même temps en séparant chaque identifiant de correctif supplémentaire par un espace :

./vendor/bin/magento-patches apply MAGETWO-XXXX MAGETWO-YYYY

Vous devez nettoyer le cache après l’application des correctifs pour afficher les modifications dans l’application Adobe Commerce :

./bin/magento cache:clean

INFO

Pensez à conserver une liste de correctifs appliqués à un emplacement distinct. Vous devrez peut-être réappliquer certaines d’entre elles après la mise à niveau vers une nouvelle version d’Adobe Commerce. Voir Réappliquer les correctifs après une mise à niveau.

Rétablissement de correctifs individuels

WARNING

Pour rétablir un seul correctif, exécutez la commande suivante où MAGETWO-XXXX correspond à l’identifiant de correctif spécifié dans le tableau d’état :

./vendor/bin/magento-patches revert MAGETWO-XXXX

Vous pouvez également rétablir plusieurs correctifs en même temps en séparant chaque identifiant de correctif supplémentaire par un espace :

./vendor/bin/magento-patches revert MAGETWO-XXXX MAGETWO-YYYY

Pour rétablir tous les correctifs appliqués :

./vendor/bin/magento-patches revert --all

Vous devez nettoyer le cache après le rétablissement des correctifs pour afficher les modifications dans l’application Adobe Commerce :

./bin/magento cache:clean

Obtenir des mises à jour

Adobe Commerce publie régulièrement de nouveaux correctifs individuels. Vous devez mettre à jour le Quality Patches Tool pour obtenir de nouveaux correctifs individuels :

composer update magento/quality-patches

Affichez les correctifs ajoutés :

TIP

Les nouveaux correctifs ajoutés s’affichent au bas du tableau.

./vendor/bin/magento-patches status

Réappliquer les correctifs après une mise à niveau re-apply-patches-after-an-upgrade

Lorsque vous effectuez une mise à niveau vers une nouvelle version d’Adobe Commerce, vous devez réappliquer les correctifs si ceux-ci ne sont pas inclus dans la nouvelle version.

Pour appliquer à nouveau les correctifs :

Mettez à jour le Quality Patches Tool :

code language-bash
`composer update magento/quality-patches.`

Ouvrez la liste des correctifs précédemment appliqués, ce qui a été recommandé dans Appliquer des correctifs individuels.

Appliquez les correctifs suivants :

code language-bash
`./vendor/bin/magento-patches apply MAGETWO-XXXX`

La bonne pratique consiste à appliquer les correctifs un par un.

Nettoyez le cache :

code language-bash
`./bin/magento cache:clean`

note info
INFO
Lorsque vous exécutez la commande `status`, les correctifs qui étaient inclus dans la nouvelle version ne s'affichent plus dans le tableau des correctifs disponibles.

Journalisation

Le Quality Patches Tool consigne toutes les opérations dans le fichier <Magento_root>/var/log/patch.log.

recommendation-more-help

c2d96e17-5179-455c-ad3a-e1697bb4e8c3