文档Commerce安装指南

系统要求

最近更新： 2025年3月20日
  • 主题：

创建对象：

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

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

在Commerce on Cloud的依赖项方面有一些差异。 Adobe Commerce on Cloud的服务版本和兼容性支持由测试并部署到托管云环境的服务决定，有时不同于Adobe Commerce内部部署支持的版本。 例如，内部部署支持Elasticsearch 7.17的Commerce 2.4.4，而Cloud上的Adobe Commerce 2.4.4支持OpenSearch 1。

NOTE
系统要求仅适用于Adobe Commerce的发行版本。 不包括Beta或早期访问版本。 请参阅发行说明以了解有关Adobe Commerce最新发行版本的更多信息。

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

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

云端上的 Commerce

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

软件依赖项2.4.8
Composer2.8
Elasticsearch—
OpenSearch2
MariaDB11.4
New Relic11.5.0.18+， 10.15.0.4+
PHP8.4/8.3
RabbitMQ4
RedisValkey 8
软件依赖项2.4.7 - p52.4.7 - p42.4.7 - p32.4.7 - p22.4.7 - p12.4.7
Composer2.82.82.72.72.72.7
Elasticsearch——————
OpenSearch222222
MariaDB10.610.610.610.610.610.6
New Relic10.15.0.4+， 10.7.0.319+10.15.0.4+， 10.7.0.319+10.15.0.4+， 10.7.0.319+10.15.0.4+， 10.7.0.319+10.15.0.4+， 10.7.0.319+10.15.0.4+， 10.7.0.319+
PHP8.3/8.28.3， 8.28.3， 8.28.3， 8.28.3， 8.28.3， 8.2
RabbitMQ3.133.133.133.133.123.12
Redis7.27.27.27.27.27.2
软件依赖项2.4.6-p102.4.6-p92.4.6-p82.4.6-p72.4.6-p62.4.6 - p52.4.6-p42.4.6-p32.4.6 - p22.4.6-p12.4.6
Composer2.22.22.22.22.22.22.22.22.22.22.2
Elasticsearch———————————
OpenSearch22222222222
MariaDB10.610.610.610.610.610.610.610.610.610.610.6
New Relic10.7.0.319+， 9.19.0.309+10.7.0.319+， 9.19.0.309+10.7.0.319+， 9.19.0.309+10.7.0.319+， 9.19.0.309+10.7.0.319+， 9.19.0.309+10.7.0.319+， 9.19.0.309+10.7.0.319+， 9.19.0.309+10.7.0.319+， 9.19.0.309+10.7.0.319+， 9.19.0.309+10.7.0.319+， 9.19.0.309+10.7.0.319+， 9.19.0.309+
PHP8.2、8.18.2、8.18.2、8.18.2、8.18.2、8.18.2、8.18.2、8.18.2、8.18.2、8.18.2、8.18.2、8.1
RabbitMQ3.133.133.133.133.123.12、3.11、3.93.11、3.93.11、3.93.11、3.93.11、3.93.11、3.9
Redis7.27.27.27.07.07.07.07.07.07.07.0
软件依赖项2.4.5-p122.4.5-p112.4.5-p102.4.5-p92.4.5-p82.4.5-p72.4.5-p62.4.5-p52.4.5-p42.4.5-p32.4.5 - p22.4.5-p12.4.5
Composer2.22.22.22.22.22.22.22.22.22.22.22.22.2
Elasticsearch—————————————
OpenSearch2111111111111
MariaDB10.610.6， 10.510.510.510.5， 10.410.410.410.410.410.410.410.410.4
New Relic9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+
PHP8.18.18.18.18.18.18.18.18.18.18.18.18.1
RabbitMQ3.133.133.133.133.12、3.113.12、3.11、3.93.11、3.93.11、3.93.11、3.93.11、3.93.93.93.9
Redis7.27.27.27.07.07.06.26.26.26.26.26.26.2
软件依赖项2.4.4-p132.4.4-p122.4.4-p112.4.4-p102.4.4 - p92.4.4-p82.4.4-p72.4.4-p62.4.4 - p52.4.4-p42.4.4 - p32.4.4 - p22.4.4-p12.4.4
Composer2.22.22.22.22.22.22.22.22.22.22.22.12.12.1
Elasticsearch——————————————
OpenSearch21111111111111
MariaDB10.610.6， 10.510.510.510.5， 10.410.410.410.410.410.410.410.410.410.4
New Relic9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+9.19.0.309+
PHP8.18.18.18.18.18.18.18.18.18.18.18.18.18.1
RabbitMQ3.93.93.93.93.93.93.93.93.93.93.93.93.93.9
Redis7.27.27.27.07.07.06.26.26.26.26.26.26.26.2
软件依赖项2.4.3-p3
Composer1
Elasticsearch—
OpenSearch1
MariaDB10.4
New Relic—
PHP7.4
RabbitMQ3.8
Redis6.0
软件依赖项2.4.2 - p2
Composer1
Elasticsearch7.9
OpenSearch—
MariaDB10.4
New Relic—
PHP7.4
RabbitMQ3.8
Redis6.0

在文件services.yaml中定义了服务和版本。 以下是云基础架构上Commerce 2.4.6的默认服务配置：

mysql:
    type: mysql:10.6
    disk: 5120

redis:
    type: redis:7.0

opensearch:
    type: opensearch:2
    disk: 1024

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

Commerce内部部署
NOTE
Versions 2.4.4 and 2.4.5 support MySQL 8.0.0 through 8.0.28 only.
软件依赖项
2.4.8
Composer
2.8
Elasticsearch
8.17
OpenSearch
2.19
MariaDB
11.4
MySQL
8.4
PHP
8.4/8.3
RabbitMQ
4
Redis
Valkey 8
Varnish
7.6
Apache
2.4
nginx
1.26
AWS Aurora (MySQL)
8.0.mysql_aurora.3.08或最新可用版本
AWS S3
✔️
AWS MQ
3.13或最新版本
AWS ElastiCache
适用于Redis OSS的ElastiCache 7.1版（增强）
AWS Elasticsearch
—
AWS OpenSearch
2.19或最新可用版本
软件依赖项
2.4.7 - p5
2.4.7 - p4
2.4.7 - p3
2.4.7 - p2
2.4.7 - p1
2.4.7
Composer
2.8
2.8
2.7
2.7
2.7
2.7
Elasticsearch
7.17/8.17
8.16
8.11
8.11
8.11
8.11
OpenSearch
2.19
2.12
2.12
2.12
2.12
2.12
MariaDB
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
PHP
8.3/8.2
8.3， 8.2
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
3.13
3.13
Redis
7.2
7.2
7.2
7.2
7.2
7.2
Varnish
7.6
7.6
7.5
7.5
7.5
7.5
Apache
2.4
2.4
2.4
2.4
2.4
2.4
nginx
1.26
1.26
1.26
1.26
1.26
1.26
AWS Aurora (MySQL)
8.0.mysql_aurora.3.08或最新可用版本
8.0
8.0
8.0
8.0
8.0
AWS S3
✔️
✔️
✔️
✔️
✔️
✔️
AWS MQ
3.13或最新可用版本
3.13
3.11.20
3.11.20
3.11.20
3.11.20
AWS ElastiCache
适用于Redis OSS的ElastiCache 7.1版（增强）
Redis 7.0
Redis 7.0
Redis 7.0
Redis 7.0
Redis 7.0
AWS Elasticsearch
—
—
—
—
—
—
AWS OpenSearch
2.19或最新可用版本
2.11
2.11
2.11
2.11
2.11
软件依赖项
2.4.6-p10
2.4.6-p9
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
2.2
2.2
Elasticsearch
7.17/8.17
7.17
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.19
2.12
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
10.6
10.6
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.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
8.2、8.1
8.2、8.1
RabbitMQ
3.13
3.13
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.2
7.2、7.0
7.0
7.0
7.0
7.0
7.0
7.0
7.0
7.0
Varnish
7.6
7.6
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
2.4
2.4
nginx
1.26
1.26
1.26
1.26
1.26
1.26
1.26
1.26
1.22
1.22
1.22
AWS Aurora (MySQL)
8.0.mysql_aurora.3.08或最新可用版本
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.13或最新可用版本
3.13
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 OSS的ElastiCache版本7.1（增强型）
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
Redis 6.2
AWS Elasticsearch
—
—
—
—
—
—
—
—
—
—
—
AWS OpenSearch
2.19或最新可用版本
1.2
1.2
1.2
1.2
1.2
1.2
1.2
1.2
1.2
1.2
软件依赖项
2.4.5-p12
2.4.5-p11
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
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
7.17
7.17
OpenSearch
2.19
1.3.20
1.3
1.3
1.3
1.3
1.2
1.2
1.2
1.2
1.2
1.2
1.2
MariaDB
10.6
10.6， 10.5
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
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
8.1
RabbitMQ
3.13
3.13
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.2
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.6
7.6
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
2.4
2.4
nginx
1.26
1.26
1.26
1.26
1.26
1.26
1.26
1.26
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
8.0
8.0
AWS S3
✔️
✔️
✔️
✔️
✔️
✔️
✔️
✔️
✔️
✔️
✔️
✔️
✔️
AWS MQ
3.13
3.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
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
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
1.2
1.2
软件依赖项
2.4.4-p13
2.4.4-p12
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.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.17
7.17
7.16
7.16
7.16
OpenSearch
2.19
1.3.20
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.6
10.6、10.5
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
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
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
3.9
3.9
Redis
7.2
7.2
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.6
7.6
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
2.4
2.4
nginx
1.26
1.26
1.26
1.26
1.26
1.26
1.26
1.26
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
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.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
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
1.2
1.2
—
—
—
软件依赖项
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
—
软件依赖项
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扩展。

默认扩展
安装的扩展无法卸载
可以根据需要安装和卸载的扩展
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-ftp
  • 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-ftp
  • 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需要以下系统工具才能进行某些操作：

  • bash
  • gzip
  • lsof
  • mysql
  • mysqldump
  • nice
  • php
  • sed
  • tar

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