[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeが管理する PaaS インフラストラクチャ）およびオンプレミスプロジェクトにのみ適用されます。"}

アップグレードの実行

Last update: Mon May 04 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

経験者
管理者
開発者

次の方法でソフトウェアをインストールした場合、コマンドラインから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 before アップグレードを使用してComposer 2と互換性のあるバージョン（2.4.2など）にアップグレードし、2.4.2を超えるアップグレードを実行する必要があります。さらに、PHPのサポートされているバージョンを実行している必要があります。

WARNING

Adobe Commerceのアップグレード手順が変更されました。新しいバージョンのmagento/composer-root-update-plugin パッケージをインストールする必要があります（前提条件を参照）。さらに、アップグレード用のコマンドがcomposer require magento/<package_name>からcomposer require-commerce magento/<package_name>に変更されました。

始める前に

アップグレードプロセスを開始する前に、環境を準備するには、アップグレードの前提条件を完了する必要があります。

IMPORTANT

Adobe Commerce バージョン 2.4.6-p13には、magento/inventory-composer-installer パッケージが含まれていません。これは、下位互換性のない変更を含む古いマイナーバージョンからスムーズにアップグレードするために必要です。

2.3から2.4.6-p13にアップグレードする場合は、アップグレードする前に次のコマンドを実行してmagento/inventory-composer-installer パッケージをインストールします。>composer require magento/inventory-composer-installer

パッケージの管理

NOTE

様々なリリースレベルを指定する方法については、この節の最後にある例を参照してください。例えば、品質パッチやセキュリティパッチなどです。 Composerでこれらのパッケージが見つからない場合は、Adobe Commerce サポートにお問い合わせください。

メンテナンスモードに切り替えて、アップグレードプロセス中にストアにアクセスできないようにします。

code language-shell
`bin/magento maintenance:enable`

その他のオプションについては、メンテナンスモードを有効または無効にするを参照してください。オプションで、カスタムメンテナンスモードページを作成できます。

メッセージキューコンシューマーなどの非同期プロセスの実行中にアップグレードプロセスを開始すると、データが破損する可能性があります。データの破損を防ぐには、すべてのcron ジョブを無効にします。

Adobe Commerce（クラウドインフラストラクチャ上） :

code language-shell
`./vendor/bin/ece-tools cron:disable`

Magento Open Source :

code language-shell
`bin/magento cron:remove`

すべてのメッセージキューのコンシューマーを手動で開始して、すべてのメッセージが確実に消費されるようにします。

code language-shell
`bin/magento cron:run --group=consumers`

cron ジョブが完了するのを待ちます。すべてのプロセスが完了するまで、プロセスビューアを使用するか、ps aux | grep 'bin/magento queue' コマンドを複数回実行することで、ジョブのステータスを監視できます。

composer.json ファイルのバックアップを作成します。

code language-shell
`cp composer.json composer.json.bak`

ニーズに基づいて特定のパッケージを追加または削除します。

例えば、Magento Open SourceからAdobe Commerceにアップグレードする場合は、Magento Open Source パッケージを削除します。

code language-shell
`composer remove magento/product-community-edition --no-update`

サンプルデータをアップグレードすることもできます。

code language-shell
`composer require <sample data module-1>:<version> ... <sample data module-n>:<version> --no-update`

Adobe Commerce :

code language-shell

code language-shell
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

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-shell

code language-shell
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 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-shell
`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を参照してください。

依存関係を更新します。

code language-shell
`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

メタデータを更新

必要に応じて、composer.json ファイルの"name"、"version"および"description" フィールドを更新します。

note note
NOTE
`composer.json` ファイルのメタデータの更新は、完全に表面的で、機能しません。

アップデートの適用。

code language-shell
`composer update`

var/とgenerated/個のサブディレクトリをクリアします。

code language-shell
`rm -rf var/cache/*`

code language-shell
`rm -rf var/page_cache/*`

code language-shell
`rm -rf generated/code/*`

note note
NOTE
RedisやMemcachedなどのファイルシステム以外のキャッシュストレージを使用する場合は、そのキャッシュも手動でクリアする必要があります。

データベーススキーマとデータを更新します。

code language-shell
`bin/magento setup:upgrade`

メンテナンスモードを無効にします。

code language-shell
`bin/magento maintenance:disable`

（オプション） Varnishを再起動します。

ページのキャッシュにVarnishを使用する場合は、再起動します。

code language-shell
`service varnish restart`

作品を確認する

アップグレードが成功したかどうかを確認するには、web ブラウザーでストアフロント URLを開きます。アップグレードに失敗した場合、ストアフロントが正しく読み込まれません。

アプリケーションがWe're sorry, an error has occurred while generating this email. エラーで失敗した場合：

ファイルシステムの所有権と権限をroot権限を持つユーザーとしてリセットします。
次のディレクトリをクリアします。
- var/cache/
- var/page_cache/
- generated/code/
もう一度web ブラウザーでストアフロントを確認します。

recommendation-more-help

83a60e0e-8849-4685-a8cd-c129ecd795ea