文件Commerce工具

使用狀況

Last update: Thu Apr 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Experienced
  • Admin
  • Developer

此 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.json 檔案：
composer require magento/quality-patches

檢視個別修補程式

若要檢視適用於您Adobe Commerce版本的個別修補程式清單：

./vendor/bin/magento-patches status

您會看到類似下列的輸出：

Id
標題
型別
狀態
詳細資料
MAGECLOUD-5069
FPC在部署期間遭到停用
可選
未套用
受影響的元件：
- magento/module-page-cache
MCLOUD-5650
從檔案讀取後保留部署設定
可選
未套用
受影響的元件：
- magento/框架
MCLOUD-5684
分頁無法運作 — product_list_limit=all
可選
未套用
受影響的元件： - magento/module-elasticsearch
MCLOUD-5837
修正負載平衡器問題
已棄用
已套用
建議的替代方案：MC-1
受影響的元件： - magento/框架
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。

狀態表格包括：

  • 型別：

    • Optional — 所有修補程式，來自 Quality Patches Tool 和 雲端基礎結構上的Commerce指南>套用修補程式 套件是安裝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