DocumentationCommerceOutils

Utilisation

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Expérimenté
  • Administration
  • Développeur

Quality Patches Tool fournit des correctifs individuels développés par Adobe et par la communauté du Magento Open Source. Il vous permet d’appliquer, de rétablir 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 aux projets Adobe Commerce, quel que soit le développeur du correctif. 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 individuels pour obtenir des instructions sur l’application de correctifs à vos projets Adobe Commerce. Voir Quality Patches Tool : Recherchez 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 Quality Patches Tool. Ajoutez le package du compositeur magento/quality-patches à 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

Vous verrez une sortie similaire à celle-ci :

Id
Titre
Type
État
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 affectés :
- magento/framework
MCLOUD-5684
La pagination ne fonctionne pas - product_list_limit=all
Facultatif
Non appliqué
Composants concernés : - magento/module-élasticsearch
MCLOUD-5837
Correction du problème de l’équilibreur de charge
Obsolète
Appliqué
Remplacement recommandé : MC-1
Composants affectés : - magento/framework
BUNDLE-2554
Bogue Définir les informations de paiement
Facultatif
Non appliqué
Composants affectés :
- amzn/amazon-pay-module
MC-1
Correction du problème 1
Facultatif
Appliqué
Composants affectés :
- magento/module-cms
MC-2
Correction du problème 2
Facultatif
Non appliqué
Composants affectés :
- magento/module-cms
MC-3
Correction du problème 3
Facultatif
Non appliqué
Correctifs requis :
- MC-2
Composants affectés :
- magento/module-cms
MC-3-V2
Correctif mis à jour pour le problème 3, qui remplace le correctif MC-3
Facultatif
N/A
Composants affectés :
- magento/module-cms

Adobe Commerce 2.3.5.

Le tableau d’état comprend :

  • Type :

    • Optional — Tous les correctifs du package Quality Patches Tool et du Guide d’infrastructure de Commerce on Cloud > Appliquer les correctifs sont facultatifs pour les installations Adobe Commerce.
    • Deprecated — Adobe a abandonné 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.

  • Status :

    • Applied — Le correctif a été appliqué.
    • Not applied — Le correctif n’a pas été appliqué.
    • N/A — L’état du correctif ne peut pas être défini en raison de conflits.

  • Détails :

    • Affected components — Liste des modules affectés.
    • Required patches — Liste des correctifs qui doivent être appliqués pour qu’un correctif indiqué fonctionne correctement (dépendances).
    • Recommended replacement — Correctif recommandé pour remplacer 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 des 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 média et de la base de données.

Pour appliquer un seul correctif, exécutez la commande suivante où MAGETWO-XXXX est l’identifiant de correctif spécifié dans la table des statuts :

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

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

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

Vous devez nettoyer le cache après avoir appliqué des correctifs pour voir les modifications apportées à l’application Adobe Commerce :

./bin/magento cache:clean
INFO
Envisagez de conserver une liste des 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 des correctifs après une mise à niveau.

Rétablissement de correctifs individuels

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 média et de la base de données.

Pour rétablir un seul correctif, exécutez la commande suivante où MAGETWO-XXXX est l’identifiant de correctif spécifié dans la table des statuts :

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

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

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

Pour annuler tous les correctifs appliqués :

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

Vous devez nettoyer le cache après avoir restauré les correctifs pour voir les modifications apportées à 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 Quality Patches Tool pour obtenir de nouveaux correctifs individuels :

composer update magento/quality-patches

Affichez les correctifs ajoutés :

TIP
De nouveaux correctifs s’affichent au bas du tableau.
./vendor/bin/magento-patches status

Réappliquer des 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 réappliquer des correctifs :

  1. Mettez à jour le Quality Patches Tool :

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

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

  3. Appliquez les correctifs :

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

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

  4. Nettoyez le cache :

    code language-bash 
    ./bin/magento cache:clean
    note info
    INFO
    Lorsque vous exécutez la commande status, les correctifs inclus dans la nouvelle version ne sont plus affichés dans le tableau des correctifs disponibles.

Journalisation

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