執行升級
您可以升級 內部部署 如果您是透過下列方式安裝軟體，請從命令列部署Adobe Commerce應用程式：
- 使用下載撰寫器中繼資料
composer create-project命令。 - 安裝壓縮的封存。
- 如需雲端基礎結構專案的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。
magento/composer-root-update-plugin 封裝(請參閱 必備條件)。 此外，用於升級的命令已由 composer require magento/<package_name> 至 composer require-commerce magento/<package_name>.開始之前
您必須完成 升級必備條件 在開始升級程式之前準備環境。
管理套件
-
切換到維護模式，以防止在升級過程中存取您的存放區。
code language-bash bin/magento maintenance:enable -
在非同步處理序（例如訊息佇列取用者）執行時啟動升級處理序，可能會導致資料損毀。 若要防止資料損毀，請停用所有cron工作。
雲端基礎結構上的Adobe Commerce：
code language-bash ./vendor/bin/ece-tools cron:disableMagento Open Source：
code language-bash bin/magento cron:remove -
手動啟動所有訊息佇列取用者，以確保所有訊息都已使用。
code language-bash bin/magento cron:run --group=consumers等待cron工作完成。 您可以使用程式檢視器或透過執行
ps aux | grep 'bin/magento queue'多次命令，直到所有處理程式完成。 -
建立備份
composer.json檔案。code language-bash cp composer.json composer.json.bak -
根據您的需求，新增或移除特定套件。
例如，如果您要從Magento Open Source升級至Adobe Commerce，請移除Magento Open Source套件。
code language-bash composer remove magento/product-community-edition --no-update您也可以升級範例資料。
code language-bash composer require <sample data module-1>:<version> ... <sample data module-n>:<version> --no-update-
Adobe Commerce：
code language-bash 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：
code language-bash 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
-
-
使用以下專案升級您的執行個體
composer require-commerce命令語法：code language-bash 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指定後，該命令會保留衝突的現有值，並顯示警告訊息。 若要進一步瞭解外掛程式，請參閱 外掛程式使用方式讀我檔案. -
-
更新相依性。
code language-bash 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
範例 — 安全性修補程式
安全性修補程式僅包含安全性修正。 這些設定可讓升級程式更快、更輕鬆。 安全性修補程式使用撰寫器命名慣例 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
更新中繼資料
-
更新
"name"，"version"、和"description"中的欄位composer.json檔案。note note NOTE 更新中的中繼資料 composer.json檔案完全是表面的，無法運作。 -
套用更新。
code language-bash composer update -
清除
var/和generated/子目錄：code language-bash rm -rf var/cache/*code language-bash rm -rf var/page_cache/*code language-bash rm -rf generated/code/*note note NOTE 如果您使用檔案系統以外的快取儲存體，例如Redis或Memcached，您也必須手動清除其中的快取。 -
更新資料庫結構和資料。
code language-bash bin/magento setup:upgrade -
停用維護模式。
code language-bash bin/magento maintenance:disable -
（可選） 重新啟動Varnish。
如果您使用Varnish來快取頁面，請重新啟動它：
code language-bash service varnish restart
檢查您的工作
若要檢查升級是否成功，請在網頁瀏覽器中開啟店面URL。 如果您的升級不成功，您的店面將無法正確載入。
如果應用程式失敗並出現 We're sorry, an error has occurred while generating this email. 錯誤：
-
重設 檔案系統擁有權和許可權 作為使用者，具有
root許可權。 -
清除下列目錄：
var/cache/var/page_cache/generated/code/
-
再次在網頁瀏覽器中檢視您的店面。