文件Commerce工具

使用狀況

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

建立對象：

  • 經驗豐富
  • 管理員
  • 開發人員

Quality Patches Tool提供由Adobe和Magento Open Source社群開發的個別修補程式。 它可讓您套用、還原和檢視已安裝的Adobe Commerce版本可用的所有個別修補程式的一般資訊。 無論修補程式的開發者是誰，您都可以將修補程式套用至Adobe Commerce專案。 例如，您可以將社群開發的修補程式套用至Adobe Commerce專案。

觀看此技術影片，瞭解如何使用Adobe Commerce的Quality Patches Tool。

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
BUNDLE-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。

狀態表格包括：

  • 型別：

    • Commerce Optional — Quality Patches Tool和雲端基礎結構指南>套用修補程式套件中的所有修補程式都是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
最佳實務是在部署至生產環境之前，先在中繼或開發環境中測試所有修補程式。 也建議您在套用修補程式前先備份資料。 請參閱備份及復原檔案系統、媒體及資料庫。

若要還原單一修補程式，請執行以下命令，其中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

    最佳實務是一次套用一個修補程式。

  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