文件Commerce升級指南

執行升級

最後更新： 2024年7月15日
  • 主題：

建立對象：

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

如果您是透過下列方式安裝軟體，則可以從命令列升級Adobe Commerce應用程式的​ 內部部署 ​部署：

  • 正在使用composer create-project命令下載Composer中繼資料。
  • 安裝壓縮的封存。
NOTE
  • 如需雲端基礎結構專案上的Adobe Commerce，請參閱雲端指南中的升級Commerce版本。
  • 如果您複製GitHub存放庫，請勿使用此方法來升級。 請參閱升級Git安裝。

下列指示說明如何使用Composer封裝管理員進行升級。 Adobe Commerce 2.4.2推出對Composer 2的支援。 如果您嘗試從<2.4.1升級，您必須先使用Composer 1 升級到Composer 2以進行>2.4.2升級之前，升級到與Composer 2相容的版本（例如，2.4.2）。 此外，您必須執行支援的PHP版本。

WARNING
升級Adobe Commerce的程式已變更。 您必須安裝新版本的magento/composer-root-update-plugin套件（請參閱必要條件）。 此外，用於升級的命令已從composer require magento/<package_name>變更為composer require-commerce magento/<package_name>。

開始之前

您必須先完成升級必要條件，才能開始升級程式前準備環境。

管理套件

NOTE
請參閱本節結尾的範例，以取得指定不同發行層級的說明。 例如，品質修補程式和安全修補程式。 如果您在Composer中找不到這些套件，請聯絡Adobe Commerce支援。

  1. 切換到維護模式，以防止在升級過程中存取您的存放區。

    bin/magento maintenance:enable

    如需其他選項，請參閱啟用或停用維護模式。 您可以選擇建立自訂維護模式頁面。

  2. 在非同步處理序（例如訊息佇列取用者）執行時啟動升級處理序，可能會導致資料損毀。 若要防止資料損毀，請停用所有cron工作。

    雲端基礎結構上的​ Adobe Commerce：

    ./vendor/bin/ece-tools cron:disable

    Magento Open Source：

    bin/magento cron:remove

  3. 手動啟動所有訊息佇列取用者，以確保所有訊息都已使用。

    bin/magento cron:run --group=consumers

    等待cron工作完成。 您可以使用程式檢視器或多次執行ps aux | grep 'bin/magento queue'命令來監視工作的狀態，直到所有程式完成為止。

  4. 建立composer.json檔案的備份。

    cp composer.json composer.json.bak

  5. 根據您的需求，新增或移除特定套件。

    例如，如果您要從Magento Open Source升級至Adobe Commerce，請移除Magento Open Source套件。

    composer remove magento/product-community-edition --no-update

    您也可以升級範例資料。

    composer require <sample data module-1>:<version> ... <sample data module-n>:<version> --no-update

    • Adobe Commerce：

      composer require magento/module-bundle-sample-data:100.4.* magento/module-widget-sample-data:100.4.* magento/module-theme-sample-data:100.4.* magento/module-catalog-sample-data:100.4.* magento/module-customer-sample-data:100.4.* magento/module-cms-sample-data:100.4.*  magento/module-catalog-rule-sample-data:100.4.* magento/module-sales-rule-sample-data:100.4.* magento/module-review-sample-data:100.4.* magento/module-tax-sample-data:100.4.* magento/module-sales-sample-data:100.4.* magento/module-grouped-product-sample-data:100.4.* magento/module-downloadable-sample-data:100.4.* magento/module-msrp-sample-data:100.4.* magento/module-configurable-sample-data:100.4.* magento/module-product-links-sample-data:100.4.* magento/module-wishlist-sample-data:100.4.* magento/module-swatches-sample-data:100.4.* magento/sample-data-media:100.4.* magento/module-offline-shipping-sample-data:100.4.* magento/module-gift-card-sample-data:100.4.* magento/module-customer-balance-sample-data:100.4.* magento/module-target-rule-sample-data:100.4.* magento/module-gift-registry-sample-data:100.4.* magento/module-multiple-wishlist-sample-data:100.4.* --no-update

    • Magento Open Source：

      composer require magento/module-bundle-sample-data:100.4.* magento/module-widget-sample-data:100.4.* magento/module-theme-sample-data:100.4.* magento/module-catalog-sample-data:100.4.* magento/module-customer-sample-data:100.4.* magento/module-cms-sample-data:100.4.*  magento/module-catalog-rule-sample-data:100.4.* magento/module-sales-rule-sample-data:100.4.* magento/module-review-sample-data:100.4.* magento/module-tax-sample-data:100.4.* magento/module-sales-sample-data:100.4.* magento/module-grouped-product-sample-data:100.4.* magento/module-downloadable-sample-data:100.4.* magento/module-msrp-sample-data:100.4.* magento/module-configurable-sample-data:100.4.* magento/module-product-links-sample-data:100.4.* magento/module-wishlist-sample-data:100.4.* magento/module-swatches-sample-data:100.4.* magento/sample-data-media:100.4.* magento/module-offline-shipping-sample-data:100.4.* --no-update

  6. 使用下列composer require-commerce命令語法升級您的執行個體：

    composer require-commerce magento/<product> <version> --no-update [--interactive-root-conflicts] [--force-root-updates] [--help]

    命令選項包括：

    • <product> — （必要）要升級的套件。 對於內部部署安裝，此值必須是product-community-edition或product-enterprise-edition。

    • <version> — （必要）您要升級至的Adobe Commerce版本。 例如，2.4.3。

    • --no-update — （必要）停用相依性的自動更新。

    • --interactive-root-conflicts — （選擇性）可讓您以互動方式檢視及更新任何舊版中的過期值，或與您要升級至之版本不相符的任何自訂值。

    • --force-root-updates — （選擇性）以預期的Commerce值覆寫所有衝突的自訂值。

    • --help — （選擇性）提供外掛程式的使用方式詳細資料。

    如果未指定--interactive-root-conflicts或--force-root-updates，則命令會保留衝突的現有值，並顯示警告訊息。 若要進一步瞭解外掛程式，請參閱外掛程式使用方式README。

  7. 更新相依性。

    composer update

範例 — 列出可用版本

若要檢視可用2.4.x版本的完整清單：

Magento Open Source：

composer show magento/product-community-edition 2.4.* --available | grep -m 1 versions

Adobe Commerce：

composer show magento/product-enterprise-edition 2.4.* --available | grep -m 1 versions

範例 — 品質修補程式

品質修補程式主要包含功能性​ 和 ​安全性修正。 但是，它們有時可以包含向後相容的新功能。 使用Composer下載品質修補程式。

Adobe Commerce：

composer require-commerce magento/product-enterprise-edition 2.4.6 --no-update

Magento Open Source：

composer require-commerce magento/product-community-edition 2.4.6 --no-update

範例 — 安全性修補程式

安全性修補程式僅包含安全性修正。 這些設定可讓升級程式更快、更輕鬆。 安全性修補程式使用Composer命名慣例2.4.x-px。

Adobe Commerce：

composer require-commerce magento/product-enterprise-edition 2.4.6-p3 --no-update

Magento Open Source：

composer require-commerce magento/product-community-edition 2.4.6-p3 --no-update

更新中繼資料

  1. 視需要更新composer.json檔案中的"name"、"version"和"description"欄位。

    NOTE
    更新composer.json檔案中的中繼資料完全是表面性的，無法運作。

  2. 套用更新。

    composer update

  3. 清除var/和generated/子目錄：

    rm -rf var/cache/*

    rm -rf var/page_cache/*

    rm -rf generated/code/*
    NOTE
    如果您使用檔案系統以外的快取儲存體，例如Redis或Memcached，您也必須手動清除其中的快取。

  4. 更新資料庫結構和資料。

    bin/magento setup:upgrade

  5. 停用維護模式。

    bin/magento maintenance:disable

  6. （選擇性） ​重新啟動清漆。

    如果您使用Varnish來快取頁面，請重新啟動它：

    service varnish restart

檢查您的工作

若要檢查升級是否成功，請在網頁瀏覽器中開啟店面URL。 如果您的升級不成功，您的店面將無法正確載入。

如果應用程式失敗並出現We're sorry, an error has occurred while generating this email.錯誤：

  1. 將檔案系統擁有權和許可權重設為具有root許可權的使用者。

  2. 清除下列目錄：

    • var/cache/
    • var/page_cache/
    • generated/code/

  3. 再次在網頁瀏覽器中檢視您的店面。

recommendation-more-help
83a60e0e-8849-4685-a8cd-c129ecd795ea