文档Commerce安装指南

系统要求

最近更新： 2026年5月19日

创建对象：

  • Experienced
  • Admin
  • Developer

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

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

IMPORTANT
系统要求表列出了它们适用的Adobe Commerce版本，包括标记为测试版或抢先体验的版本。
有关最新发布的Commerce版本，请参阅发行说明。
当您的服务版本与Commerce版本支持的配置不匹配时，行为可能与Adobe在测试中重现的行为不同。 Adobe支持部门可能会要求您在调查、故障排除或验证报告的行为之前，将环境与支持的配置保持一致。 调整环境后，Adobe支持部门可以继续调查。

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

Adobe仅支持下表列出的系统要求组合。 Adobe不验证或支持与列出的组合不匹配的配置。 例如，Adobe Commerce 2.4.9通过MariaDB 12.3进行测试。 在升级到2.4.9之前，请升级到MariaDB 12.3。

最新Commerce发行版本的系统要求

下表汇总了所有受支持的Commerce版本的最新版本的系统要求。 Adobe建议所有客户都升级到这些版本。

云端上的 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

1MariaDB 12.3与Adobe Commerce 2.4.9之间的兼容性
MariaDB 12.3正式发布后，MariaDB 12.3与Adobe Commerce 2.4.9之间的兼容性将得到确认，预计将在5-6月时间范围内发布。

对于默认配置，服务和版本定义在的services.yaml文件中。
有关更多详细信息，请参阅 云基础架构上的Commerce ​指南中的配置服务。

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 12.3
MySQL 8.4
PHP 8.5
RabbitMQ 4.2
ActiveMQ Artemis 2
Valkey 9
Varnish 8
nginx 1.30
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.30 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.30 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.30 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.30 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.30 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版本。

早期Commerce版本的系统要求

下表列出了Adobe Commerce版本的系统要求，包括扩展支持中的要求。 提供这些表仅供参考。 Adobe不建议使用不支持的软件依赖项版本，支持团队要求您将环境与支持的配置相协调，然后才能调查、排除或验证报告的行为。

NOTE
该表将折叠以最小化此文章的长度。 选择标题可将其展开。
早期版本的要求
tabs
云端上的 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 8-row-5 9-row-5 layout-auto
软件依赖项 2.4.8-p3 2.4.8-p2 2.4.8-p1 2.4.8
Composer 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+
OpenSearch 3 3 2 2
MariaDB 11.4 11.4 11.4 11.4
New Relic 11.5.0.18+, 10.15.0.4+ 11.5.0.18+, 10.15.0.4+ 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 8.4, 8.3 8.4, 8.3
RabbitMQ 4.1 4.1 4.1 4.1
ActiveMQ Artemis 2 不支持 不支持 不支持
Valkey 8 8 8 8
nginx 1.28 1.28 1.26 1.26
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 layout-auto
软件依赖项 2.4.7-p8 2.4.7 - p7 2.4.7 - p6 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.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+
OpenSearch 2 2 2 2 2 2 2 2 2
MariaDB 10.11 10.11 10.11 10.6 10.6 10.6 10.6 10.6 10.6
New Relic 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+ 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+
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 8.3, 8.2 8.3, 8.2 8.3, 8.2
RabbitMQ 4.1 4.1 4.1, 3.13 4.1, 3.13 3.13 3.13 3.13 3.12 3.12
ActiveMQ Artemis 2 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持
Redis 7.2 7.2 7.2 7.2 7.2 7.2 7.2 7.2 7.2
Valkey 8 8 8 不支持 不支持 不支持 不支持 不支持 不支持
nginx 1.28 1.28 1.26 1.26 1.26 1.26 1.26 1.26 1.26
table 0-row-15 1-row-15 2-row-15 3-row-15 4-row-15 5-row-15 6-row-15 7-row-15 8-row-15 9-row-15 10-row-15 layout-auto
软件依赖项 2.4.6-p13 2.4.6-p12 2.4.6-p11 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.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+
OpenSearch 2 2 2 2 2 2 2 2 2 2 2 2 2 2
MariaDB 10.11 10.11 10.11 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6
New Relic 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+ 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+
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 8.2, 8.1 8.2, 8.1 8.2, 8.1
RabbitMQ 4.1 4.1 4.1, 3.13 4.1, 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
ActiveMQ Artemis 2 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持
Redis 7.2 7.2 7.2 7.2 7.2 7.2 7.0 7.0 7.0 7.0 7.0 7.0 7.0 7.0
Valkey 8 8 8 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持
nginx 1.28 1.28 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.22 1.22 1.22
table 0-row-17 1-row-17 2-row-17 3-row-17 4-row-17 5-row-17 6-row-17 7-row-17 8-row-17 9-row-17 layout-auto
软件依赖项 2.4.5-p15 2.4.5-p14 2.4.5-p13 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.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+
OpenSearch 2 2 2 2 1 1 1 1 1 1 1 1 1 1 1 1
MariaDB 10.6 10.6 10.6 10.6 10.6, 10.5 10.5 10.5 10.5, 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
New Relic 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+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+
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 8.1 8.1
RabbitMQ 4.1 4.1 4.1, 3.13 4.1, 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.2 7.2 7.2 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2
Valkey 8 8 8 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持 不支持
nginx 1.28 1.28 1.26 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
table 0-row-18 1-row-18 2-row-18 3-row-18 4-row-18 5-row-18 6-row-18 7-row-18 8-row-18 layout-auto
软件依赖项 2.4.4-p16 2.4.4-p15 2.4.4-p14 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.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+
OpenSearch 2 2 2 2 1 1 1 1 1 1 1 1 1 1 1 1 1
MariaDB 10.6 10.6 10.6 10.6 10.6, 10.5 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
New Relic 不支持 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+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+
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 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 3.9 3.9 3.9
Redis 7.2 7.2 7.2 7.2 7.2 7.2 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2 6.2
nginx 1.28 1.28 1.26 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

对于默认配置，服务和版本定义在的services.yaml文件中。
有关更多详细信息，请参阅 云基础架构上的Commerce ​指南中的配置服务。
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 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.8-p3 2.4.8-p2 2.4.8-p1 2.4.8
Composer 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+
Elasticsearch 8 8 8 8.17
OpenSearch 3 3 2.19 2.19
MariaDB 11.4 11.4 11.4 11.4
MySQL 8.4 8.4 8.4 8.4
PHP 8.4, 8.3 8.4, 8.3 8.4, 8.3 8.4, 8.3
RabbitMQ 4.1 4.1 4.1 4.1
ActiveMQ Artemis 2 -- -- --
Valkey 8 8 8 8
Varnish 7.7 7.7 7.7 7.6
Apache -- 2.4 2.4 2.4
nginx 1.28 1.28 1.26 1.26
AWS Aurora (MySQL) 8.0.mysql_aurora.3.09或最新可用版本 8.0.mysql_aurora.3.09或最新可用版本 8.0.mysql_aurora.3.08或最新可用版本 8.0.mysql_aurora.3.08或最新可用版本
AWS S3 ✔️ ✔️ ✔️ ✔️
AWS MQ 3.13或最新可用版本 3.13或最新可用版本 3.13或最新可用版本 3.13或最新可用版本
AWS ElastiCache 适用于Redis OSS的ElastiCache版本7.1（增强型）。 Valkey 8可供使用。 适用于Redis OSS的ElastiCache版本7.1（增强型） 适用于Redis OSS的ElastiCache版本7.1（增强型） 适用于Redis OSS的ElastiCache版本7.1（增强型）
AWS OpenSearch 2.19或最新可用版本 2.19或最新可用版本 2.19或最新可用版本 2.19或最新可用版本
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 18-row-10 layout-auto
软件依赖项 2.4.7-p8 2.4.7 - p7 2.4.7 - p6 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.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+
Elasticsearch 7.17/8 7.17, 8 7.17, 8 7.17,8.17 8.16 8.11 8.11 8.11 8.11
OpenSearch 2.19 2.19 2.19 2.19 2.12 2.12 2.12 2.12 2.12
MariaDB 10.11 10.11 10.11 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.3, 8.2 8.3, 8.2 8.3, 8.2 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 4.1 4.1 4.1, 3.13 4.1, 3.13 3.13 3.13 3.13 3.13 3.13
ActiveMQ Artemis 2 -- -- -- -- -- -- -- --
Redis 7.2 7.2 7.2 7.2 7.2 7.2 7.2 7.2 7.2
Valkey 8 8 8 -- -- -- -- -- --
Varnish 7.7 7.7 7.7 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 2.4
nginx 1.28 1.28 1.26 1.26 1.26 1.26 1.26 1.26 1.26
AWS Aurora (MySQL) 8.0.mysql_aurora.3.09或最新可用版本 8.0.mysql_aurora.3.09或最新可用版本 8.0.mysql_aurora.3.08或最新可用版本 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.13或最新可用版本 3.13或最新可用版本 3.13 3.11.20 3.11.20 3.11.20 3.11.20
AWS ElastiCache 适用于Redis OSS的ElastiCache版本7.1（增强型）。 Valkey 8可供使用。 适用于Redis OSS的ElastiCache版本7.1（增强型）。 Valkey 8可供使用。 适用于Redis OSS的ElastiCache版本7.1（增强型） 适用于Redis OSS的ElastiCache版本7.1（增强型） Redis 7.0 Redis 7.0 Redis 7.0 Redis 7.0 Redis 7.0
AWS OpenSearch 2.19或最新可用版本 2.19或最新可用版本 2.17或最新可用版本 2.19或最新可用版本 2.11 2.11 2.11 2.11 2.11
table 0-row-15 1-row-15 2-row-15 3-row-15 4-row-15 5-row-15 6-row-15 7-row-15 8-row-15 9-row-15 10-row-15 11-row-15 12-row-15 13-row-15 14-row-15 15-row-15 16-row-15 17-row-15 18-row-15 layout-auto
软件依赖项 2.4.6-p13 2.4.6-p12 2.4.6-p11 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.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+
Elasticsearch 7.17 7.17 7.17 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.19 2.19 2.19 2.12 2.12 2.12 2.12 2.12 2.5 2.5 2.5 2.5 2.5
MariaDB 10.11 10.11 10.11 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 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 8.2, 8.1 8.2, 8.1 8.2, 8.1
RabbitMQ 4.1 4.1 4.1, 3.13 4.1, 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
ActiveMQ Artemis 2 -- -- -- -- -- -- -- -- -- -- -- -- --
Redis 7.2 7.2 7.2 7.2 7.2 7.2, 7.0 7.0 7.0 7.0 7.0 7.0 7.0 7.0 7.0
Valkey 8 8 8 -- -- -- -- -- -- -- -- -- -- --
Varnish 7.7 7.7 7.7 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 2.4
nginx 1.28 1.28 1.26 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.09或最新可用版本 8.0.mysql_aurora.3.09或最新可用版本 8.0.mysql_aurora.3.08或最新可用版本 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.13或最新可用版本 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（增强型）。 Valkey 8可供使用。 适用于Redis OSS的ElastiCache版本7.1（增强型）。 Valkey 8可供使用。 适用于Redis OSS的ElastiCache版本7.1（增强型） 适用于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 OpenSearch 2.19或最新可用版本 2.19或最新可用版本 2.19或最新可用版本 2.19或最新可用版本 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
table 0-row-17 1-row-17 2-row-17 3-row-17 4-row-17 5-row-17 6-row-17 7-row-17 8-row-17 9-row-17 10-row-17 11-row-17 12-row-17 13-row-17 14-row-17 15-row-17 16-row-17 17-row-17 18-row-17 layout-auto
软件依赖项 2.4.5-p15 2.4.5-p14 2.4.5-p13 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.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+
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 7.17 7.17 7.17
OpenSearch 2.19 2.19 2.19 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.6 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 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 8.1 8.1
RabbitMQ 4.1 4.1 4.1, 3.13 4.1, 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.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
Valkey 8 8 8 -- -- -- -- -- -- -- -- -- -- -- -- --
Varnish 7.7 7.7 7.7 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 2.4
nginx 1.28 1.28 1.26 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.mysql_aurora.3.09或最新可用版本 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.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 --
AWS ElastiCache -- 适用于Redis OSS的ElastiCache版本7.1（增强型）。 Valkey 8可供使用。 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 --
AWS OpenSearch -- 2.19或最新可用版本 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 --
table 0-row-18 1-row-18 2-row-18 3-row-18 4-row-18 5-row-18 6-row-18 7-row-18 8-row-18 9-row-18 10-row-18 11-row-18 12-row-18 13-row-18 14-row-18 15-row-18 16-row-18 17-row-18 layout-auto
软件依赖项 2.4.4-p16 2.4.4-p15 2.4.4-p14 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.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+
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 7.17 7.16 7.16 7.16
OpenSearch 2.19 2.19 2.19 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.6 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 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 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 3.9 3.9 3.9
Redis 7.2 7.2 7.2 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.7 7.7 7.7 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 2.4
nginx 1.28 1.28 1.26 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 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.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 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 1.2 -- -- --

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版本。

PHP设置

有特定的PHP配置设置，如memory_limit设置，可帮助您在使用Adobe Commerce时避免常见问题。 请参阅必需的PHP设置。

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

PHP OPcache

Adobe建议您验证是否出于性能原因启用了PHP OPcache。 OPcache在许多PHP分发中启用。

  • 对于云基础架构部署上的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。 在主要版本中安装PHPUnit作为命令行工具，该版本与针对您的发行版测试的Adobe配置相匹配。

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-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指南。

浏览器

店面和管理员：

  • Microsoft Edge（最新和以前的主要版本）
  • Firefox（任何操作系统上的最新和以前的主要版本）
  • Chrome（任何操作系统上的最新和以前的主要版本）
  • Safari（仅限macOS上的最新和以前的主要版本）
  • 适用于iOS的Safari（店面的最新和以前的主要版本）
  • Chrome for Android（店面的最新和以前的主要版本）

邮件服务器

邮件传输代理(MTA)或SMTP服务器。 云基础架构上的Commerce使用SendGrid电子邮件服务。

内存

升级从Commerce Marketplace和其他来源获得的应用程序和扩展最多可能需要2 GB的RAM。 如果您使用的系统RAM小于2 GB，请创建交换文件。 否则，升级可能会失败。

操作系统(Linux x86-64)

Linux发行版，如Red Hat 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
commerce-operations-help-installation