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

必要システム構成

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

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

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

クラウドインフラストラクチャ上のCommerceの依存関係には、いくつかの違いがあります。 クラウドインフラストラクチャー上のAdobe Commerceのサービスのバージョンと互換性のサポートは、テストしてホストされるクラウド環境にデプロイしたサービスによって決まり、Adobe Commerceのオンプレミスデプロイメントでサポートされているバージョンとは異なる場合があります。 例えば、オンプレミスデプロイメントではElasticsearch 7.17 がCommerce 2.4.4 でサポートされていますが、Cloud Infrastructure 上のCommerce 2.4.4 では OpenSearch 1.2 がサポートされています。

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

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

クラウド上のCommerce

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

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.7-p1 2.4.7
Composer 2.7 2.7
Elasticsearch — —
OpenSearch 2.12 2.12
MariaDB 10.6 10.6
PHP 8.3, 8.2#8.3# 8.3, 8.2#8.3#
RabbitMQ 3.12 3.12
Redis 7.2 7.2
table 0-row-8 1-row-8 2-row-8 3-row-8 4-row-8 5-row-8 6-row-8 7-row-8 layout-auto
ソフトウェアの依存関係 2.4.6-p6 2.4.6-p5 2.4.6-p4 2.4.6-p3 2.4.6-p2 2.4.6-p1 2.4.6
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2
Elasticsearch — — — — — — —
OpenSearch 2.12 2.12 2.5 2.5 2.5 2.5 2.5
MariaDB 10.6 10.6 10.6 10.6 10.6 10.6 10.6
PHP 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1
RabbitMQ 3.12 3.12、3.11、3.9 3.11、3.9 3.11、3.9 3.11、3.9 3.11、3.9 3.11、3.9
Redis 7.0 7.0 7.0 7.0 7.0 7.0 7.0
table 0-row-10 1-row-10 2-row-10 3-row-10 4-row-10 5-row-10 6-row-10 7-row-10 layout-auto
ソフトウェアの依存関係 2.4.5-p8 2.4.5-p7 2.4.5-p6 2.4.5-p5 2.4.5-p4 2.4.5-p3 2.4.5-p2 2.4.5-p1 2.4.5
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2
Elasticsearch — — — — — — — — —
OpenSearch 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.5、10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 3.12、3.11 3.12、3.11、3.9 3.11、3.9 3.11、3.9 3.11、3.9 3.11、3.9 3.9 3.9 3.9
Redis 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2
table 0-row-11 1-row-11 2-row-11 3-row-11 4-row-11 5-row-11 6-row-11 7-row-11 layout-auto
ソフトウェアの依存関係 2.4.4-p9 2.4.4-p8 2.4.4-p7 2.4.4-p6 2.4.4-p5 2.4.4-p4 2.4.4-p3 2.4.4-p2 2.4.4-p1 2.4.4
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.1 2.1 2.1
Elasticsearch — — — — — — — — — —
OpenSearch 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.5、10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9
Redis 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2 6.2
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 layout-auto
ソフトウェアの依存関係 2.4.3-p3
Composer 1
Elasticsearch —
OpenSearch 1.2
MariaDB 10.4
PHP 7.4
RabbitMQ 3.8
Redis 6.0
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 layout-auto
ソフトウェアの依存関係 2.4.2-p2
Composer 1
Elasticsearch 7.9
OpenSearch —
MariaDB 10.4
PHP 7.4
RabbitMQ 3.8
Redis 6.0

サービスとバージョンは services.yaml ファイルで定義されます。 クラウドインフラストラクチャー上のCommerce 2.4.6 のデフォルトのサービス設定は、次のとおりです。

code language-yaml 
mysql:
    type: mysql:10.6
    disk: 5120

redis:
    type: redis:7.0

opensearch:
    type: opensearch:2
    disk: 1024

クラウドインフラストラクチャー上の 2}Commerce ガイドの { サービスの設定 を参照してください。

Commerce オンプレミス
note note
NOTE
バージョン 2.4.4 および 2.4.5 は、MySQL 8.0.0 ～ 8.0.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 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-p1 2.4.7
Composer 2.7 2.7
Elasticsearch 8.11 8.11
OpenSearch 2.12 2.12
MariaDB 10.6 10.6
MySQL 8.0 8.0
PHP 8.3, 8.2#8.3# 8.3, 8.2#8.3#
RabbitMQ 3.13 3.13
Redis 7.2 7.2
Varnish 7.5 7.5
Apache 2.4 2.4
nginx 1.24 1.24
AWS Aurora (MySQL) 8.0 8.0
AWS S3 ✔️ ✔️
AWS MQ 3.11.20 3.11.20
AWS ElastiCache Redis 7.0 Redis 7.0
AWS Elasticsearch — —
AWS OpenSearch 2.11 2.11
table 0-row-8 1-row-8 2-row-8 3-row-8 4-row-8 5-row-8 6-row-8 7-row-8 8-row-8 9-row-8 10-row-8 11-row-8 12-row-8 13-row-8 14-row-8 15-row-8 16-row-8 17-row-8 layout-auto
ソフトウェアの依存関係 2.4.6-p6 2.4.6-p5 2.4.6-p4 2.4.6-p3 2.4.6-p2 2.4.6-p1 2.4.6
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2
Elasticsearch 8.11、7.17 8.11、7.17 8.11、7.17 8.5、7.17 8.5、7.17 8.5、7.17 8.4、7.17
OpenSearch 2.12 2.12 2.5 2.5 2.5 2.5 2.5
MariaDB 10.6 10.6 10.6 10.6 10.6 10.6 10.6
MySQL 8.0 8.0 8.0 8.0 8.0 8.0 8.0
PHP 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1
RabbitMQ 3.12 3.12、3.11、3.9 3.11、3.9 3.11、3.9 3.11、3.9 3.11、3.9 3.11、3.9
Redis 7.0 7.0 7.0 7.0 7.0 7.0 7.0
Varnish 7.5 7.5 7.3 7.3 7.3 7.3 7.1
Apache 2.4 2.4 2.4 2.4 2.4 2.4 2.4
nginx 1.24 1.24 1.24 1.24 1.22 1.22 1.22
AWS Aurora (MySQL) 8.0 8.0 8.0 8.0 8.0 8.0 8.0
AWS S3 ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
AWS MQ 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16
AWS ElastiCache Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2
AWS Elasticsearch — — — — — — —
AWS OpenSearch 1.2 1.2 1.2 1.2 1.2 1.2 1.2
table 0-row-10 1-row-10 2-row-10 3-row-10 4-row-10 5-row-10 6-row-10 7-row-10 8-row-10 9-row-10 10-row-10 11-row-10 12-row-10 13-row-10 14-row-10 15-row-10 16-row-10 17-row-10 layout-auto
ソフトウェアの依存関係 2.4.5-p8 2.4.5-p7 2.4.5-p6 2.4.5-p5 2.4.5-p4 2.4.5-p3 2.4.5-p2 2.4.5-p1 2.4.5
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2
Elasticsearch 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17
OpenSearch 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.5、10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
MySQL 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 3.12、3.11 3.12、3.11、3.9 3.11、3.9 3.11、3.9 3.11、3.9 3.11、3.9 3.9 3.9 3.9
Redis 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2
Varnish 7.5 7.5 7.3 7.3 7.3 7.3 7.1 7.0 7.0
Apache 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4
nginx 1.24 1.24 1.24 1.24 1.22 1.22 1.22 1.22 1.22
AWS Aurora (MySQL) 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
AWS S3 ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
AWS MQ 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13
AWS ElastiCache Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6
AWS Elasticsearch — — — — — — — 7.9 7.9
AWS OpenSearch 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
table 0-row-11 1-row-11 2-row-11 3-row-11 4-row-11 5-row-11 6-row-11 7-row-11 8-row-11 9-row-11 10-row-11 11-row-11 12-row-11 13-row-11 14-row-11 15-row-11 16-row-11 17-row-11 layout-auto
ソフトウェアの依存関係 2.4.4-p9 2.4.4-p8 2.4.4-p7 2.4.4-p6 2.4.4-p5 2.4.4-p4 2.4.4-p3 2.4.4-p2 2.4.4-p1 2.4.4
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.1 2.1 2.1
Elasticsearch 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.16 7.16 7.16
OpenSearch 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.5、10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
MySQL 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9
Redis 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2 6.2
Varnish 7.5 7.5 7.3 7.3 7.3 7.3 7.1 7.0 7.0 7.0
Apache 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4
nginx 1.24 1.24 1.24 1.24 1.22 1.22 1.22 1.22 1.22 1.22
AWS Aurora (MySQL) 8.0 8.0 8.0 8.0 8.0 8.0 8.0 5.7 5.7 5.7
AWS S3 ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
AWS MQ 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.8.11 3.8.11 3.8.11
AWS ElastiCache Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6
AWS Elasticsearch — — — — — — — 7.9 7.9 7.9
AWS OpenSearch 1.2 1.2 1.2 1.2 1.2 1.2 1.2 — — —
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 16-row-2 17-row-2 layout-auto
ソフトウェアの依存関係 2.4.3-p3
Composer 1
Elasticsearch 7.16
OpenSearch 1.2
MariaDB 10.4
MySQL 8.0
PHP 7.4
RabbitMQ 3.8
Redis 6.0
Varnish 6.5
Apache 2.4
nginx 1.18
AWS Aurora (MySQL) 5.7
AWS S3 ✔️
AWS MQ 3.8.11
AWS ElastiCache Redis 6
AWS Elasticsearch 7.9
AWS OpenSearch —
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 16-row-2 17-row-2 layout-auto
ソフトウェアの依存関係 2.4.2-p2
Composer 1
Elasticsearch 7.9
OpenSearch —
MariaDB 10.4
MySQL 8.0
PHP 7.4
RabbitMQ 3.8
Redis 6.0
Varnish 6.4
Apache 2.4
nginx 1.18
AWS Aurora (MySQL) —
AWS S3 ✔️
AWS MQ —
AWS ElastiCache —
AWS Elasticsearch —
AWS OpenSearch —

PHP 設定

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

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

PHP OPcache

パフォーマンス上の理由から、PHP OPcache が有効になっていることを確認することをお勧めします。 OPcache は多くの PHP ディストリビューションで有効になっています。 opcache 拡張機能は、クラウドインフラストラクチャー上のCommerceにデフォルトでインストールされます。

オンプレミスの場合は、PHP OPcache がインストールされていることを確認してください。PHP 設定を参照してください。 パフォーマンス設定に関する具体的なガイダンスについては、『 パフォーマンスのベストプラクティス ガイドの PHP 設定に関するソフトウェアの推奨事項を参照してください。

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

PHP プロセスコントロール

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

PHPUnit

PHPUnit v9 （コマンドラインツールとして）。

PHP 拡張機能

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

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

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

table 0-row-3 1-row-3 layout-auto
デフォルトの拡張機能 アンインストールできないインストール済み拡張機能 必要に応じてインストールおよびアンインストールできる拡張機能
bcmath
bz2
カレンダー
exif
gd
gettext
intl
libxml
mysqli
opcache
openswoole
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-gd
  • ext-hash
  • ext-iconv
  • ext-intl
  • ext-json
  • ext-libxml
  • ext-mbstring
  • ext-openssl
  • ext-pcre
  • ext-pdo_mysql
  • 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-gd
  • ext-hash
  • ext-iconv
  • ext-intl
  • ext-json
  • ext-libxml
  • ext-mbstring
  • ext-openssl
  • ext-pcre
  • ext-pdo_mysql
  • 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に関するガイダンスを提供します。

ブラウザー

ストアフロントおよび管理者：

  • Microsoft Edge（最新および以前のメジャーバージョン）
  • Firefox （最新および以前のメジャーバージョン、あらゆるオペレーティングシステム）
  • Chrome（最新および以前のメジャーバージョン、あらゆるオペレーティングシステム）
  • Safari （最新および以前のメジャーバージョン、macOSのみ）
  • iOS用 Safari （ストアフロント用の最新および以前のメジャーバージョン）
  • Android用のChrome（ストアフロント用の最新および以前のメジャーバージョン）

メールサーバー

メール転送エージェント（MTA）または SMTP サーバー。 クラウドインフラストラクチャー上のCommerceでは、SendGrid メールサービスを使用します。

メモリ

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

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

Linux ディストリビューション（RedHat Enterprise Linux （RHEL）、CentOS、Ubuntu、Debian など）。 Microsoft Windows とmacOSはサポートされていません。

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

SSL

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

クラウドインフラストラクチャー上のCommerceについては、クラウドインフラストラクチャー上のCommerce🔗 ガイドの Fastly 設定 を参照してください。

Xdebug

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

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

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