文档Commerce安装指南

系统要求

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 有经验的
  • 管理员
  • 开发人员

下面总结了为Adobe Commerce测试的软件依赖项和服务。

在云基础架构上，Commerce的依赖项存在一些差异。 云基础架构上Adobe Commerce的服务版本和兼容性支持取决于测试和部署到托管云环境的服务，有时不同于Adobe Commerce内部部署支持的版本。 例如，内部部署支持Elasticsearch7.17的Commerce 2.4.4，而云基础架构上的Commerce 2.4.4支持OpenSearch 1.2。

下表显示了Adobe使用特定Adobe Commerce版本测试的第三方软件依赖项版本。

Adobe仅支持下表中描述的系统要求组合。 例如，2.4.5已通过MariaDB 10.4进行了全面测试。Adobe建议您在升级到2.4.5之前升级到MariaDB 10.4。

云端上的Commerce

Commerce on Cloud模板为与特定Commerce版本兼容的服务提供了默认配置。

table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5 5-row-5 6-row-5 7-row-5 layout-auto
软件依赖项 2.4.7 - p3 2.4.7 - p2 2.4.7 - p1 2.4.7
Composer 2.7 2.7 2.7 2.7
Elasticsearch — — — —
OpenSearch 2.12 2.12 2.12 2.12
MariaDB 10.6 10.6 10.6 10.6
PHP 8.3， 8.2 8.3， 8.2 8.3， 8.2 8.3， 8.2
RabbitMQ 3.13 3.13 3.12 3.12
Redis 7.2 7.2 7.2 7.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 layout-auto
软件依赖项 2.4.6-p8 2.4.6-p7 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 2.2 2.2
Elasticsearch — — — — — — — — —
OpenSearch 2.12 2.12 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 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 8.2、8.1 8.2、8.1
RabbitMQ 3.13 3.13 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.2 7.0 7.0 7.0 7.0 7.0 7.0 7.0 7.0
table 0-row-12 1-row-12 2-row-12 3-row-12 4-row-12 5-row-12 6-row-12 7-row-12 layout-auto
软件依赖项 2.4.5-p10 2.4.5-p9 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 2.2 2.2
Elasticsearch — — — — — — — — — — —
OpenSearch 1.3 1.3 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.5 10.5 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 8.1 8.1
RabbitMQ 3.13 3.13 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.2 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2
table 0-row-13 1-row-13 2-row-13 3-row-13 4-row-13 5-row-13 6-row-13 7-row-13 layout-auto
软件依赖项 2.4.4-p11 2.4.4-p10 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.2 2.2 2.1 2.1 2.1
Elasticsearch — — — — — — — — — — — —
OpenSearch 1.3 1.3 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.5 10.5 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 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 3.9 3.9
Redis 7.2 7.0 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

请参阅​ 云基础架构上的Commerce ​指南中的配置服务。

Commerce内部部署
note note
NOTE
版本2.4.4和2.4.5仅支持MySQL 8.0.0到8.0.28。
table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5 5-row-5 6-row-5 7-row-5 8-row-5 9-row-5 10-row-5 11-row-5 12-row-5 13-row-5 14-row-5 15-row-5 16-row-5 17-row-5 layout-auto
软件依赖项 2.4.7 - p3 2.4.7 - p2 2.4.7 - p1 2.4.7
Composer 2.7 2.7 2.7 2.7
Elasticsearch 8.11 8.11 8.11 8.11
OpenSearch 2.12 2.12 2.12 2.12
MariaDB 10.6 10.6 10.6 10.6
MySQL 8.0 8.0 8.0 8.0
PHP 8.3， 8.2 8.3， 8.2 8.3， 8.2 8.3， 8.2
RabbitMQ 3.13 3.13 3.13 3.13
Redis 7.2 7.2 7.2 7.2
Varnish 7.5 7.5 7.5 7.5
Apache 2.4 2.4 2.4 2.4
nginx 1.24 1.24 1.24 1.24
AWS Aurora (MySQL) 8.0 8.0 8.0 8.0
AWS S3 ✔️ ✔️ ✔️ ✔️
AWS MQ 3.11.20 3.11.20 3.11.20 3.11.20
AWS ElastiCache Redis 7.0 Redis 7.0 Redis 7.0 Redis 7.0
AWS Elasticsearch — — — —
AWS OpenSearch 2.11 2.11 2.11 2.11
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.6-p8 2.4.6-p7 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 2.2 2.2
Elasticsearch 8.11、7.17 8.11、7.17 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.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 10.6 10.6
MySQL 8.0 8.0 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 8.2、8.1 8.2、8.1
RabbitMQ 3.13 3.13 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.2、7.0 7.0 7.0 7.0 7.0 7.0 7.0 7.0 7.0
Varnish 7.5 7.5 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 2.4 2.4
nginx 1.24 1.24 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 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 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 Redis 6.2 Redis 6.2
AWS Elasticsearch — — — — — — — — —
AWS OpenSearch 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
table 0-row-12 1-row-12 2-row-12 3-row-12 4-row-12 5-row-12 6-row-12 7-row-12 8-row-12 9-row-12 10-row-12 11-row-12 12-row-12 13-row-12 14-row-12 15-row-12 16-row-12 17-row-12 layout-auto
软件依赖项 2.4.5-p10 2.4.5-p9 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 2.2 2.2
Elasticsearch 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17
OpenSearch 1.3 1.3 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.5， 10.4 10.5， 10.4 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 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 8.1
RabbitMQ 3.13 3.13 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.2、7.0 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2
Varnish 7.5 7.5 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 2.4 2.4
nginx 1.24 1.24 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 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 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 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 1.2 1.2
table 0-row-13 1-row-13 2-row-13 3-row-13 4-row-13 5-row-13 6-row-13 7-row-13 8-row-13 9-row-13 10-row-13 11-row-13 12-row-13 13-row-13 14-row-13 15-row-13 16-row-13 17-row-13 layout-auto
软件依赖项 2.4.4-p11 2.4.4-p10 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.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.17 7.17 7.16 7.16 7.16
OpenSearch 1.3 1.3 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.5， 10.4 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 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 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 3.9 3.9
Redis 7.2、7.0 7.0 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.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 2.4 2.4
nginx 1.24 1.24 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 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.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 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 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设置。

有关云配置指南，请参阅​ 云基础架构上的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平台上部署Adobe Commerce时支持的PHP扩展。

table 0-row-3 1-row-3 layout-auto
默认扩展 安装的扩展无法卸载 可以根据需要安装和卸载的扩展
bcmath
bz2
日历
exif
gd
gettext
intl
libxml
mysqli
opcache
pcntl
pdo_mysql
反射
soap
套接字
SPL
standard
swoole
sysvmsg
sysvsem
sysvshm
zip
zlib		 ctype
curl
日期
dba
dom
文件信息
筛选器
ftp
哈希
iconv
json
mbstring
mysqlnd
openssl
pcre
pdo
pdo_sqlite
phar
posix
读取行
会话
sqlite3
tokenizer
xml
xmlreader
xmlwriter		 geoip
gmp
igbinary
imagick
imap
ldap
mailparse
mcrypt
msgpack
mysqli
oauth
pdo_mysql
propro
拼写
raphf
recode
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证书。
  • 传输层安全性(TLS)要求 — PayPal和repo.magento.com都需要TLS 1.2或更高版本。

有关云基础架构上的Commerce，请参阅​ 云基础架构上的Commerce ​指南中的Fastly配置。

Xdebug

对于Adobe Commerce，请使用php_xdebug 2.5.x或更高版本（仅适用于开发环境；可能会对性能产生不利影响）。

有关云上的Adobe Commerce，请参阅​ 云基础架构上的Commerce ​指南中的配置Xdebug。

NOTE
xdebug存在已知问题，该问题可能会影响Adobe Commerce安装或安装后对店面或管理员的访问。 在​_Commerce支持知识库_​中查看影响xdebug安装🔗的已知问题。
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995