Requisitos do sistema

A seguir é apresentado um resumo das dependências de software e dos serviços testados para Adobe Commerce.

Há algumas diferenças nas dependências da infraestrutura do Commerce na nuvem. O suporte à versão do serviço e à compatibilidade do Adobe Commerce na infraestrutura em nuvem é determinado por serviços testados e implantados nos ambientes de nuvem hospedados e, às vezes, difere das versões compatíveis com implantações locais do Adobe Commerce. Por exemplo, o Elasticsearch 7.17 é compatível com o Commerce 2.4.4 para implantações locais, mas o OpenSearch 1.2 é compatível com o Commerce 2.4.4 na infraestrutura em nuvem.

As tabelas a seguir mostram versões de dependências de software de terceiros que o Adobe testou com versões específicas do Adobe Commerce.

O Adobe suporta apenas a combinação dos requisitos de sistema descritos nas tabelas a seguir. Por exemplo, 2.4.5 é totalmente testado com MariaDB 10.4. A Adobe recomenda que você atualize para MariaDB 10.4 antes de atualizar para a versão 2.4.5.

Commerce na nuvem

O modelo do Commerce na Nuvem fornece uma configuração padrão para serviços compatíveis com uma versão específica do 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
Dependências de software 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.2
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
Dependências de software 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
Dependências de software 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
Dependências de software 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
Dependências de software 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
Dependências de software 2.4.2-p2
Composer 1
Elasticsearch 7,9
OpenSearch
MariaDB 10,4
PHP 7,4
RabbitMQ 3,8
Redis 6,0

Os serviços e as versões estão definidos no arquivo services.yaml. A seguir está a configuração de serviço padrão para o Commerce 2.4.6 na infraestrutura em nuvem:

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

redis:
    type: redis:7.0

opensearch:
    type: opensearch:2
    disk: 1024

Consulte Configurar serviços no guia do Commerce on Cloud Infrastructure.

Commerce local
note note
NOTE
As versões 2.4.4 e 2.4.5 são compatíveis somente com o MySQL 8.0.0 até 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
Dependências de software 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.2
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
Dependências de software 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
Dependências de software 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
Dependências de software 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
Dependências de software 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
Dependências de software 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

Configurações do PHP

Há configurações específicas do PHP, como a configuração memory_limit, que podem ajudá-lo a evitar problemas comuns ao usar o Adobe Commerce. Consulte Configurações PHP necessárias.

Para obter orientações sobre a configuração da nuvem, consulte configurações do PHP no guia Commerce na Infraestrutura da Nuvem.

OPcache do PHP

É recomendável verificar se o PHP OPcache está habilitado por motivos de desempenho. O OPcache está habilitado em muitas distribuições PHP. A extensão opcache é instalada por padrão na infraestrutura do Commerce na nuvem.

Para configurações no local, verifique se o PHP OPcache está instalado, consulte configurações do PHP. Ou, para obter orientação específica sobre configurações de desempenho, consulte as recomendações de software para configurações de PHP no guia Práticas recomendadas de desempenho.

Se você precisar instalar o OPcache separadamente, consulte a documentação do OPcache do PHP.

Controle do processo PHP

Antes de executar indexadores no modo paralelo, você deve habilitar o suporte de Controle de Processo (pcntl) no PHP. Consulte Instalação na documentação do PHP.

PHPUnit

PHPUnit v9 (como uma ferramenta de linha de comando).

Extensões PHP

As instruções de instalação do PHP incluem uma etapa para instalar essas extensões.

TIP
Para extensões PHP na infraestrutura da nuvem, consulte Habilitar extensões PHP no guia Commerce na infraestrutura da nuvem.
Commerce na nuvem

A tabela a seguir mostra as extensões compatíveis do PHP ao implantar o Adobe Commerce na plataforma na nuvem.

table 0-row-3 1-row-3 layout-auto
Extensões padrão Extensões instaladas que não podem ser desinstaladas Extensões que podem ser instaladas e desinstaladas conforme necessário
bcmath
bz2
calendário
exif
gd
gettext
intl
libxml
mysqli
opcache
openswoole
pcntl
pdo_mysql
Reflexo
soap
soquetes
SPL
padrão
sysvmsg
sistema
sysvshm
zip
zlib
ctype
curl
data
dba
dom
fileinfo
filtro
ftp
hash
Iconv
json
mbstring
mysqlnd
openssl
pcre
pdo
pdo_sqlite
phar
posix
linha de leitura
sessão
sqlite3
tokenizer
xml
xmlreader
xmlwriter
geoip
gmp
igbinary
imagick
imap
ldap
mailparse
mcrypt
msgpack
mysqli
oauth
pdo_mysql
propro
soletrar
raphf
recode
redis
soquetes para lojas
sódio
ssh2
arrumar
xdebug
xmlrpc
xsl
yaml
Commerce local

O Adobe Commerce exige:

  • 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

O Magento Open Source exige:

  • 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

Consulte a documentação oficial do PHP para obter detalhes sobre a instalação.

Diversos

Esta seção descreve o suporte e a compatibilidade para todos os outros tipos de software necessário e opcional.

NOTE
Os seguintes requisitos se aplicam à versão de patch 2.4.x mais recente do Adobe Commerce. Quando pertinente, são fornecidas orientações sobre a infraestrutura do Commerce na nuvem.

Loja e Administrador:

  • Microsoft Edge (versão principal mais recente e anterior)
  • Firefox (versão principal mais recente e anterior; qualquer sistema operacional)
  • Chrome (versão principal mais recente e anterior; qualquer sistema operacional)
  • Safari (versão principal mais recente e anterior; somente macOS)
  • Safari para iOS (versão principal mais recente e anterior, para loja)
  • Chrome para Android (versão principal mais recente e anterior, para loja)

Servidor de email

Mail Transfer Agent (MTA) ou um servidor SMTP. A infraestrutura do Commerce na nuvem usa o serviço de email SendGrid.

Memória

A atualização dos aplicativos e extensões obtidos do Commerce Marketplace e de outras fontes pode exigir até 2 GB de RAM. Se você estiver usando um sistema com menos de 2 GB de RAM, crie um arquivo de troca; caso contrário, a atualização poderá falhar.

Sistemas operacionais (Linux x86-64)

Distribuições Linux, como RedHat Enterprise Linux (RHEL), CentOS, Ubuntu, Debian e similares. O Microsoft Windows e o macOS não são compatíveis.

O Adobe Commerce requer as seguintes ferramentas do sistema para algumas operações:

SSL

  • Um certificado de segurança válido é necessário para HTTPS.
  • Certificados SSL autoassinados não são compatíveis.
  • Requisito de Segurança da Camada de Transporte (TLS) - PayPal e repo.magento.com exigem TLS 1.2 ou posterior.

Para obter a infraestrutura do Commerce na nuvem, consulte a Configuração do Fastly no guia do Commerce na Infraestrutura da Nuvem.

Xdebug

Para o Adobe Commerce, use o php_xdebug 2.5.x ou posterior (somente ambientes de desenvolvimento; pode ter um efeito adverso no desempenho).

Para o Adobe Commerce na nuvem, consulte Configurar Xdebug no guia do Commerce na infraestrutura da nuvem.

NOTE
Há um problema conhecido com o xdebug que pode afetar as instalações do Adobe Commerce ou o acesso à loja ou ao Administrador após a instalação. Consulte Problema conhecido que afeta a instalação de xdebug na Base de Dados de Conhecimento de Suporte da Commerce.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995