使用狀況
Quality Patches Tool提供由Adobe和Magento Open Source社群開發的個別修補程式。 它可讓您套用、還原和檢視已安裝的Adobe Commerce版本可用的所有個別修補程式的一般資訊。 無論修補程式的開發者是誰,您都可以將修補程式套用至Adobe Commerce專案。 例如,您可以將社群開發的修補程式套用至Adobe Commerce專案。
觀看此技術影片,瞭解如何使用Adobe Commerce的Quality Patches Tool。
安裝
composer require magento/quality-patches
檢視個別修補程式
若要檢視適用於您Adobe Commerce版本的個別修補程式清單:
./vendor/bin/magento-patches status
您會看到類似下列的輸出:
- magento/module-page-cache
- magento/framework
受影響的元件: - magento/framework
- amzn/amazon-pay-module
- magento/module-cms
- magento/module-cms
- MC-2
受影響的元件:
- magento/module-cms
- magento/module-cms
Adobe Commerce 2.3.5。
狀態表格包括:
-
型別:
- Commerce
Optional
— Quality Patches Tool和雲端基礎結構指南>套用修補程式套件中的所有修補程式都是Adobe Commerce安裝的選用專案。 Deprecated
—Adobe已棄用個別修補程式。 如果您已套用修補程式,建議您還原修補程式。 還原作業也會從狀態表中移除修正程式。
- Commerce
-
狀態:
Applied
— 已套用修補程式。Not applied
— 尚未套用修補程式。N/A
— 由於發生衝突,無法定義修補程式的狀態。
-
詳細資料:
Affected components
— 受影響模組的清單。Required patches
— 必須套用才能讓指定的修補程式正常運作(相依性)的修補程式清單。Recommended replacement
— 建議用來取代已棄用修補程式的修補程式。
套用個別修補程式 apply-individual-patches
若要套用單一修補程式,請執行以下命令,其中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
還原個別修補程式
若要還原單一修補程式,請執行以下命令,其中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
檢視新增的修補程式:
./vendor/bin/magento-patches status
升級後重新套用修補程式 re-apply-patches-after-an-upgrade
升級至新版Adobe Commerce時,如果新版本未包含修補程式,則必須重新套用修補程式。
若要重新套用修補程式:
-
更新Quality Patches Tool:
code language-bash composer update magento/quality-patches.
-
開啟先前套用的修補程式清單(建議在套用個別修補程式中進行)。
-
套用修補程式:
code language-bash ./vendor/bin/magento-patches apply MAGETWO-XXXX
最佳實務是一次套用一個修補程式。
-
清除快取:
code language-bash ./bin/magento cache:clean
note info INFO 當您執行 status
命令時,新版本中包含的修補程式將不再顯示在可用修補程式表格中。
記錄
Quality Patches Tool會在<Magento_root>/var/log/patch.log
檔案中記錄所有作業。