ドキュメントCommerceインストールガイド

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

必要システム構成

Last update: Tue May 12 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 経験者
  • 管理者
  • 開発者

次に、Adobe Commerce用にテストされたソフトウェアの依存関係とサービスの概要を示します。

Commerce on Cloudの依存関係にはいくつかの違いがあります。 Adobe Commerce on Cloudのサービスバージョンと互換性のサポートは、テスト済みのサービスによって決定され、ホストされたクラウド環境にデプロイされます。また、Adobe Commerce オンプレミスのデプロイメントでサポートされているバージョンと異なる場合があります。

NOTE
必要システム構成の表は、明示的にラベル付けされたベータ版または早期アクセス版を含む、対象となる特定のAdobe Commerce バージョンを示します。 Adobe Commerceの最新の公開版について詳しくは、​ リリースノート ​を参照してください。
お使いのCommerceのバージョンとサービスのバージョンが一致しない場合、サポート対象の環境では再現できない動作が生じる可能性があります。 このような場合、サポートは、報告された動作を調査、トラブルシューティング、または検証する前に、サポート対象の設定（例えば、サービスバージョンのアップグレードやダウングレード）に環境を調整することを要求する場合があります。 バージョンが調整されると、サポートは調査を進めることができます。

次の表は、Adobeが特定のAdobe Commerce リリースでテストしたサードパーティソフトウェアの依存関係のバージョンを示しています。

Adobeでは、次の表で説明する必要システム構成の組み合わせのみがサポートされます。 例えば、2.4.9はMariaDB 12.3で完全にテストされています。 Adobeでは、2.4.9にアップグレードする前にMariaDB 12.3にアップグレードすることをお勧めします。

クラウド上のCommerce

Commerce on Cloud テンプレート ​は、特定のCommerce バージョンと互換性のあるサービスのデフォルト設定を提供します。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto
ソフトウェア依存関係 2.4.9
Composer 2.9.3+
OpenSearch 3
MariaDB 11.8, 12.31
New Relic 12.5.0+
PHP 8.5
RabbitMQ 4.2
ActiveMQ Artemis 2
Valkey 9
nginx 1.28
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 layout-auto
ソフトウェア依存関係 2.4.8-p5 （最新） 2.4.8-p4
Composer 2.9.3+ 2.9.3+
OpenSearch 3 3
MariaDB 11.4, 11.8 11.4
New Relic 11.5.0.18+, 10.15.0.4+ 11.5.0.18+, 10.15.0.4+
PHP 8.4, 8.3 8.4, 8.3
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Valkey 8.1 8
nginx 1.28 1.28
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 layout-auto
ソフトウェア依存関係 2.4.7-p10 （最新） 2.4.7-p9
Composer 2.9.3+ 2.9.3+
OpenSearch 2, 3 2
MariaDB 10.11, 11.8 10.11
New Relic 10.15.0.4+, 10.7.0.319+ 10.15.0.4+, 10.7.0.319+
PHP 8.3, 8.2 8.3, 8.2
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Redis -- 7.2
Valkey 8.1 8
nginx 1.28 1.28
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 layout-auto
ソフトウェア依存関係 2.4.6-p15 （最新） 2.4.6-p14
Composer 2.2.26+ 2.2.26+
OpenSearch 2, 3 2
MariaDB 10.11 10.11
New Relic 10.7.0.319+, 9.19.0.309+ 10.7.0.319+, 9.19.0.309+
PHP 8.2, 8.1 8.2, 8.1
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Redis -- 7.2
Valkey 8.1 8
nginx 1.28 1.28
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 layout-auto
ソフトウェア依存関係 2.4.5-p17 （最新） 2.4.5-p16
Composer 2.2.26+ 2.2.26+
OpenSearch 2 2
MariaDB 10.11 10.11, 10.6
New Relic 9.19.0.309+ 9.19.0.309+
PHP 8.1 8.1
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Redis -- 7.2
Valkey 8.1 8
nginx 1.28 1.28
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 layout-auto
ソフトウェア依存関係 2.4.4-p18 （最新） 2.4.4-p17
Composer 2.2.26+ 2.2.26+
OpenSearch 2 2
MariaDB 10.6 10.6
PHP 8.1 8.1
RabbitMQ 3.9 3.9
Redis 7.2 7.2
nginx 1.28 1.28

既定の設定では、サービスとバージョンはservices.yaml ファイル ​で定義されます。
詳しくは、Commerce on Cloud Infrastructure ガイドのConfigure servicesを参照してください。

Commerce オンプレミス
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 layout-auto
ソフトウェア依存関係 2.4.9
Composer 2.9.3+
OpenSearch 3
MariaDB 11.8, 12.31
MySQL 8.4
PHP 8.5
RabbitMQ 4.2
ActiveMQ Artemis 2
Valkey 9
Varnish 8
nginx 1.28
AWS Aurora (MySQL) 8.0.mysql_aurora.3.12以降が利用可能
AWS S3 ✔️
AWS MQ 3.13以降が利用可能
AWS ElastiCache Redis OSS用ElastiCache 7.1 （強化）。 Valkey 8がリリースされました。
AWS OpenSearch 3.1以降が利用可能
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 layout-auto
ソフトウェア依存関係 2.4.8-p5 （最新） 2.4.8-p4
Composer 2.9.3+ 2.9.3+
Elasticsearch 8 8
OpenSearch 3 3
MariaDB 11.4, 11.8 11.4
MySQL 8.4 8.4
PHP 8.4, 8.3 8.4, 8.3
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Valkey 8.1 8
Varnish 8 7.7
nginx 1.28 1.28
AWS Aurora (MySQL) 8.0.mysql_aurora.3.12以降が利用可能 8.0.mysql_aurora.3.11.1以降
AWS S3 ✔️ ✔️
AWS MQ 3.13以降が利用可能 3.13以降が利用可能
AWS ElastiCache Redis OSS用ElastiCache 7.1 （強化）。 Valkey 8がリリースされました。 Redis OSS用ElastiCache 7.1 （強化）。 Valkey 8がリリースされました。
AWS OpenSearch 3.1以降が利用可能 3.1以降が利用可能
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 layout-auto
ソフトウェア依存関係 2.4.7-p10 （最新） 2.4.7-p9
Composer 2.9.3+ 2.9.3+
Elasticsearch 8 7.17/8
OpenSearch 2.19, 3 2.19
MariaDB 10.11, 11.8 10.11
MySQL -- 8.0
PHP 8.3, 8.2 8.3, 8.2
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Redis -- 7.2
Valkey 8.1 8
Varnish 8 7.7
nginx 1.28 1.28
AWS Aurora (MySQL) 8.0.mysql_aurora.3.12以降が利用可能 8.0.mysql_aurora.3.11.1以降
AWS S3 ✔️ ✔️
AWS MQ 3.13以降が利用可能 3.13以降が利用可能
AWS ElastiCache Redis OSS用ElastiCache 7.1 （強化）。 Valkey 8がリリースされました。 Redis OSS用ElastiCache 7.1 （強化）。 Valkey 8がリリースされました。
AWS OpenSearch 3.1以降が利用可能 3.1以降が利用可能
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 layout-auto
ソフトウェア依存関係 2.4.6-p15 （最新） 2.4.6-p14
Composer 2.2.26+ 2.2.26+
Elasticsearch -- 7.17
OpenSearch 2.19, 3 2.19
MariaDB 10.11 10.11
MySQL -- 8.0
PHP 8.2, 8.1 8.2, 8.1
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Redis -- 7.2
Valkey 8.1 8
Varnish 8 7.7
nginx 1.28 1.28
AWS Aurora (MySQL) 8.0.mysql_aurora.3.12以降が利用可能 8.0.mysql_aurora.3.11.1以降
AWS S3 ✔️ ✔️
AWS MQ 3.13以降が利用可能 3.13以降が利用可能
AWS ElastiCache Redis OSS用ElastiCache 7.1 （強化）。 Valkey 8がリリースされました。 Redis OSS用ElastiCache 7.1 （強化）。 Valkey 8がリリースされました。
AWS OpenSearch 3.1以降が利用可能 3.1以降が利用可能
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 layout-auto
ソフトウェア依存関係 2.4.5-p17 （最新） 2.4.5-p16
Composer 2.2.26+ 2.2.26+
Elasticsearch -- 7.17
OpenSearch 2.19 2.19
MariaDB 10.11 10.11, 10.6
MySQL -- 8.0
PHP 8.1 8.1
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Redis -- 7.2
Valkey 8.1 8
Varnish 8 7.7
nginx 1.28 1.28
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 layout-auto
ソフトウェア依存関係 2.4.4-p18 （最新） 2.4.4-p17
Composer 2.2.26+ 2.2.26+
Elasticsearch -- 7.17
OpenSearch 2.19 2.19
MariaDB 10.6 10.6
MySQL -- 8.0
PHP 8.1 8.1
RabbitMQ 3.9 3.9
Redis 7.2 7.2
Varnish 7.7 7.7
nginx 1.28 1.28

MySQL 8.0は2026年4月30日にサポート終了（EOS）に達しました。
この日付に続いて、Adobe Commerce 2.4.7、2.4.6、2.4.5、および2.4.4では互換性が提供されません。
mysql 8.0以降にリリースされたMySQL バージョンをサポートします。 Adobeでは
このAdobeの新しいMySQL メジャーバージョンの検証またはサポートの提供
Commerce リリースライン。
バージョン 2.4.7、2.4.6、2.4.5、2.4.4を実行しているすべてのAdobe Commerce オンプレミスのお客様は、以下の点に強く同意します。
データベースサーバーを互換性のあるMariaDB バージョンに移行することをお勧めします。

Elasticsearch 7.17は、2026年1月15日にサポート終了（EOS）に達しました。
この日付に続いて、Adobe Commerce 2.4.6、2.4.5、および2.4.4では互換性が提供されません。
Elasticsearch 7以降にリリースされたElasticsearchのバージョンをサポートします。 Adobeでは
このAdobeの新しいElasticsearch メジャーバージョンの検証またはサポートの提供
Commerce リリースライン。
バージョン 2.4.6、2.4.5、2.4.4を実行しているすべてのAdobe Commerce オンプレミスのお客様は、以下の点に強く同意します。
検索インフラストラクチャを互換性のあるOpenSearch バージョンに移行することをお勧めします。

AVAILABILITY
1 MariaDB 12.3とAdobe Commerce 2.4.9の互換性は、5月から6月の期間に予定されているMariaDB 12.3の正式リリース後に確定されます。

PHP設定

Adobe Commerceを使用する際の一般的な問題を回避するのに役立つmemory_limit設定など、PHPの特定の設定があります。 必要なPHP設定を参照してください。

クラウド設定ガイダンスについては、Commerce on Cloud Infrastructure ガイドのPHP settingsを参照してください。

PHP OPcache

Adobeでは、PHP OPcacheがパフォーマンス上の理由から有効になっていることを確認することをお勧めします。 OPcacheは多くのPHP ディストリビューションで有効になっています。

  • Cloud インフラストラクチャのデプロイメント​上のAdobe Commerceの場合、opcache拡張機能がデフォルトでインストールされます。

  • Adobe Commerce オンプレミス デプロイメントの場合：

OPcacheを個別にインストールする必要がある場合は、PHP OPcache ドキュメント ​を参照してください。

PHP プロセス制御

並列モードでインデクサーを実行する前に、PHPでプロセス制御サポート （pcntl）を有効にする必要があります。 PHP ドキュメントの​ インストール ​を参照してください。

PHPUnit

サポートされているPHPUnit メジャーバージョンは、Adobe Commerce リリースによって異なります。 Adobeは、PHPUnit 12では2.4.9、PHPUnit 10では2.4.8-p5、PHPUnit 9では2.4.7-p10～2.4.4-p18をテストします。 リリースのAdobe テスト済み設定に一致するメジャーバージョンで、PHPUnitをコマンドラインツールとしてインストールします。

PHP拡張機能

PHPのインストール手順には、これらの拡張機能をインストールするための手順が含まれています。

TIP
クラウドインフラストラクチャのPHP拡張機能については、Commerce on Cloud Infrastructure ガイドのPHP拡張機能の有効化を参照してください。
クラウド上のCommerce

次の表は、Adobe CommerceをCloud Platformにデプロイする際にサポートされるPHP拡張機能を示しています。

table 0-row-3 1-row-3 layout-auto
デフォルトの拡張機能 アンインストールできないインストール済み拡張機能 必要に応じてインストールおよびアンインストールできる拡張機能
bcmath
bz2
カレンダー
exif
gd
gettext
intl
libxml
mysqli
opcache
pcntl
pdo_mysql
反射
soap
ソケット
SPL
標準
スウール
sysvmsg
システムの設定
sysvshm
郵便番号
zlib		 ctype
curl
日付
dba
dom
fileinfo
フィルター
ftp
hash
iconv
json
mbstring
mysqlnd
openssl
pcre
pdo
pdo_sqlite
phar
posix
readline
セッション
sqlite3
tokenizer
xml
xmlreader
xmlwriter		 geoip
gmp
igbinary
imagick
imap
ldap
mailparse
mcrypt
msgpack
mysqli
oauth
pdo_mysql
propro
pspell
グラフ
コード
redis
shmop ソケット
ナトリウム
ssh2
ティディ
xdebug
xmlrpc
xsl
yaml
Commerce オンプレミス

Adobe Commerceには次の機能が必要です。

  • ext-bcmath
  • ext-ctype
  • ext-curl
  • ext-dom
  • ext-fileinfo
  • ext-filter
  • ext-ftp
  • ext-gd
  • ext-hash
  • ext-iconv
  • ext-intl
  • ext-json
  • ext-libxml
  • ext-mbstring
  • ext-openssl
  • ext-pcre
  • ext-pdo_mysql
  • ext-reflection
  • ext-simplexml
  • ext-soap
  • ext-sockets
  • ext-sodium
  • ext-spl
  • ext-tokenizer
  • ext-xmlwriter
  • ext-xsl
  • ext-zip
  • ext-zlib
  • lib-libxml

Magento Open Sourceには次の機能が必要です。

  • ext-bcmath
  • ext-ctype
  • ext-curl
  • ext-dom
  • ext-fileinfo
  • ext-filter
  • ext-ftp
  • ext-gd
  • ext-hash
  • ext-iconv
  • ext-intl
  • ext-json
  • ext-libxml
  • ext-mbstring
  • ext-openssl
  • ext-pcre
  • ext-pdo_mysql
  • ext-reflection
  • ext-simplexml
  • ext-soap
  • ext-sockets
  • ext-sodium
  • ext-tokenizer
  • ext-xmlwriter
  • ext-xsl
  • ext-zip
  • ext-zlib
  • lib-libxml

インストールの詳細については、公式PHP ドキュメント ​を参照してください。

その他のソフトウェア要件

この節では、その他のすべての種類の必須および任意のソフトウェアのサポートと互換性について説明します。

NOTE
Adobe Commerceの最新の2.4.x パッチリリースには、次の要件が適用されます。 必要に応じて、Commerce on Cloud インフラストラクチャガイダンスが提供されます。

ブラウザー

ストアフロントと管理者：

  • Microsoft Edge（最新および以前のメジャーバージョン）
  • Firefox （すべてのオペレーティングシステムの最新かつ以前のメジャーバージョン）
  • Chrome（任意のオペレーティングシステムの最新および以前のメジャーバージョン）
  • Safari （macOSの最新および以前のメジャーバージョンのみ）
  • Safari for iOS（ストアフロントの最新および以前のメジャーバージョン）
  • Chrome for Android（ストアフロントの最新および以前のメジャーバージョン）

メールサーバー

Mail Transfer Agent （MTA）またはSMTP サーバー。 Commerce on Cloud インフラストラクチャでは、SendGrid メールサービス ​を使用しています。

メモリ

Commerce Marketplaceやその他のソースから取得したアプリケーションや拡張機能をアップグレードするには、最大2 GBのRAMが必要になる場合があります。 2 GB未満のRAMを搭載したシステムを使用している場合は、​ スワップファイル ​を作成します。 そうしないと、アップグレードが失敗する可能性があります。

オペレーティングシステム（Linux x86-64）

Red Hat Enterprise Linux （RHEL）、CentOS、Ubuntu、DebianなどのLinux ディストリビューション。

Microsoft WindowsとmacOSは​サポートされていません。

Adobe Commerceでは、一部の操作に次のシステムツールが必要です。

SSL

  • HTTPSには有効なセキュリティ証明書が必要です。
  • 自己署名SSL証明書はサポートされていません。
  • Transport Layer Security （TLS）要件 – PayPalおよびrepo.magento.comは、どちらもTLS 1.2以降を必要とします。

Cloud Infrastructure上のCommerceについては、Cloud Infrastructure上のCommerce ガイドのFastly設定を参照してください。

Xdebug

Adobe Commerceの場合は、php_xdebug 2.5.x以降を使用してください（開発環境のみ、パフォーマンスに悪影響を与える可能性があります）。

Adobe Commerce on Cloudについては、Commerce on Cloud Infrastructure ガイドのConfigure Xdebugを参照してください。

NOTE
Adobe Commerceのインストールまたはインストール後のストアフロントまたは管理者へのアクセスに影響を与える可能性があるxdebugに既知の問題があります。 Commerce サポート サポート ナレッジベース​の「xdebug インストール 🔗」に影響する既知の問題を参照してください。
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995