ドキュメントCommerceツール

[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeが管理する PaaS インフラストラクチャ）およびオンプレミスプロジェクトにのみ適用されます。"}

使用状況

Last update: Sat Mar 28 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 経験者
  • 管理者
  • 開発者

Quality Patches Toolは、AdobeとMagento Open Source コミュニティによって開発された個別のパッチを提供します。 インストールされているバージョンのAdobe Commerceで使用できるすべての個々のパッチに関する一般的な情報を適用、取り消し、表示できます。 誰がパッチを開発したかに関係なく、Adobe Commerce プロジェクトにパッチを適用できます。 例えば、コミュニティで開発したパッチをAdobe Commerce プロジェクトに適用できます。

この​ テクニカルビデオ ​を見て、Adobe Commerceの品質パッチツールの使用方法を学びましょう。

INFO
Adobe Commerce プロジェクトにパッチを適用する手順については、個別のパッチを適用を参照してください。 「Quality Patches Tool: パッチを検索」を参照して、リリースされたパッチの完全なリストを確認してください。
WARNING
コードの複雑さが増し、新しいバージョンへのアップグレードがより困難になるため、Quality Patches Toolを使用して多数のパッチを適用することはお勧めしません。

インストール

INFO
まだインストールされていない場合は、Gitをインストールする前に、 または パッチ Quality Patches Toolをインストールする必要があります。 magento/quality-patches Composer パッケージをcomposer.json ファイルに追加します。
composer require magento/quality-patches

個別のパッチを表示

お使いのバージョンのAdobe Commerceで使用可能な個々のパッチのリストを表示するには、次の手順に従います。

./vendor/bin/magento-patches status

次のような出力が表示されます。

Id
タイトル
タイプ
ステータス
詳細
MAGECLOUD-5069
デプロイメント中にFPCが無効になる
オプション
未適用
影響を受けるコンポーネント：
- magento/module-page-cache
MCLOUD-5650
ファイルから読み取った後でデプロイメント設定を保持する
オプション
未適用
影響を受けるコンポーネント：
- magento/framework
MCLOUD-5684
ページネーションが機能しない – product_list_limit=all
オプション
未適用
影響を受けるコンポーネント：- magento/module-elasticsearch
MCLOUD-5837
ロードバランサーの問題を修正
非推奨
適用
推奨される代替品：MC-1
影響を受けるコンポーネント：- magento/framework
バンドル–2554
決済情報のバグを設定
オプション
未適用
影響を受けるコンポーネント：
- amzn/amazon-pay-module
MC-1
問題1の修正
オプション
適用
影響を受けるコンポーネント：
- magento/module-cms
MC-2
問題2の修正
オプション
未適用
影響を受けるコンポーネント：
- magento/module-cms
MC-3
問題3の修正
オプション
未適用
必要なパッチ：
- MC-2
影響を受けるコンポーネント：
- magento/module-cms
MC-3-V2
問題3の修正を更新し、MC-3 パッチを置き換えました
オプション
該当なし
影響を受けるコンポーネント：
- magento/module-cms

Adobe Commerce 2.3.5.

ステータステーブルには次のものが含まれます。

  • 種類:

    • Optional — Quality Patches ToolおよびCommerce on Cloud Infrastructure ガイド > パッチの適用 パッケージのすべてのパッチは、Adobe Commerce インストールではオプションです。
    • Deprecated — Adobeは個別のパッチを非推奨にしました。 パッチを適用した場合は、元に戻すことをお勧めします。 復元操作では、ステータステーブルからもパッチが削除されます。

  • ステータス:

    • Applied — パッチが適用されました。
    • Not applied — パッチが適用されていません。
    • N/A – 競合のため、パッチのステータスを定義できません。

  • 詳細:

    • Affected components – 影響を受けるモジュールのリスト。
    • Required patches – 指定されたパッチが正しく動作するために適用する必要があるパッチのリスト（依存関係）。
    • Recommended replacement – 非推奨パッチの推奨される代替パッチです。
INFO
新しいバージョンのAdobe Commerceにアップグレードした後、新しいバージョンにパッチが含まれていない場合は、パッチを再適用する必要があります。 アップグレード後に​ パッチを再適用するを参照してください。

個別のパッチを適用 apply-individual-patches

WARNING
実稼動にデプロイする前に、ステージング環境または開発環境のすべてのパッチをテストすることをお勧めします。 パッチを適用する前に、データをバックアップすることをお勧めします。 ​ ファイルシステム、メディア、データベースのバックアップとロールバック ​を参照してください。

単一のパッチを適用するには、次のコマンドを実行します。ここで、MAGETWO-XXXXはステータステーブルで指定されたパッチ IDです。

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

複数のパッチを同時に適用するには、追加のパッチ IDをスペースで区切ります。

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

パッチを適用した後にキャッシュをクリーニングして、Adobe Commerce アプリケーションの変更内容を確認する必要があります。

./bin/magento cache:clean
INFO
適用されたパッチのリストを別の場所に保存することを検討してください。 Adobe Commerceの新しいバージョンにアップグレードした後、一部を再適用する必要がある場合があります。 アップグレード後に​ パッチを再適用するを参照してください。

個々のパッチを元に戻す

WARNING
実稼動にデプロイする前に、ステージング環境または開発環境のすべてのパッチをテストすることをお勧めします。 パッチを適用する前に、データをバックアップすることをお勧めします。 ​ ファイルシステム、メディア、データベースのバックアップとロールバック ​を参照してください。

1つのパッチを元に戻すには、次のコマンドを実行します。ここで、MAGETWO-XXXXはステータステーブルで指定されたパッチ IDです。

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

また、追加のパッチ IDをスペースで区切ることで、複数のパッチを同時に元に戻すことができます。

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

適用したすべてのパッチを元に戻すには：

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

パッチを元に戻した後にキャッシュをクリーニングして、Adobe Commerce アプリケーションの変更内容を確認する必要があります。

./bin/magento cache:clean

アップデートする

Adobe Commerceは、新しい個別パッチを定期的にリリースします。 新しい個別のパッチを取得するには、Quality Patches Toolを更新する必要があります。

composer update magento/quality-patches

追加されたパッチを表示します。

TIP
新しい追加パッチがテーブルの下部に表示されます。
./vendor/bin/magento-patches status

アップグレード後にパッチを再適用する re-apply-patches-after-an-upgrade

新しいバージョンのAdobe Commerceにアップグレードする場合、新しいバージョンにパッチが含まれていない場合は、パッチを再適用する必要があります。

パッチを再適用するには：

  1. Quality Patches Toolを更新します。

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

  2. 以前に適用されたパッチのリストを開きます。これは、個別のパッチを適用で推奨されました。

  3. パッチを適用します。

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

    ベストプラクティスは、パッチを1つずつ適用することです。

  4. キャッシュをクリーニングします。

    code language-bash 
    ./bin/magento cache:clean
    note info
    INFO
    status コマンドを実行すると、新しいバージョンに含まれていたパッチは、使用可能なパッチのテーブルに表示されなくなります。

ログ

Quality Patches Toolは、<Magento_root>/var/log/patch.log ファイル内のすべての操作をログに記録します。

recommendation-more-help
c2d96e17-5179-455c-ad3a-e1697bb4e8c3