Magento parou depois de atualização do servidor: por que isso acontece

A Adobe só suporta as combinações de PHP, banco e OpenSearch listadas para cada versão do Magento. Quando a hospedagem troca uma dessas peças sem olhar a versão da loja, a loja sai da matriz de um dia para o outro.

A matriz on-premises da versão mais recente de cada linha, em setembro de 2026:

Versão da lojaPHPBancoOpenSearch
2.4.98.5MariaDB 12.3 ou MySQL 8.43
2.4.8-p58.4 ou 8.3MariaDB 11.4 ou 11.8, MySQL 8.43
2.4.7-p108.3 ou 8.2MariaDB 10.11 ou 11.82.19 ou 3
2.4.6-p158.2 ou 8.1MariaDB 10.112.19 ou 3
2.4.5-p17 e 2.4.4-p188.1MariaDB 10.11 (2.4.5) ou 10.6 (2.4.4)2.19

O motivo comum da mudança é o calendário do PHP: pelo php.net, o 8.1 perdeu o suporte de segurança em 31/12/2025 e o 8.2 perde em 31/12/2026. Loja em 2.4.4 ou 2.4.5 só tem o 8.1 na matriz; desligado o 8.1, ela fica sem versão suportada.

No código da 2.4.8-p4, o Magento transforma os avisos do PHP em erro, inclusive o de recurso obsoleto. Num teste com o tratador de erros dele, o trecho que roda calado no PHP 8.1 parou no 8.2 com Deprecated Functionality: Creation of dynamic property ... is deprecated. E, quando o PHP fica mais velho do que as dependências instaladas exigem, o Composer responde erro 500 com Composer detected issues in your platform.

No banco, a armadilha é silenciosa: o código que monta o schema confere a versão contra uma lista fixa, e fora dela o bin/magento setup:upgrade para com Current version of RDBMS is not supported. A vitrine segue abrindo e o problema estoura no próximo deploy ou patch.

Loja Magento com erro depois da manutenção da hospedagem: como confirmar a causa

Antes de pedir qualquer coisa, junte a prova. São quatro conferências no servidor, comparadas com a tabela acima:

  1. PHP que atende o site. ps -eo args | grep '[p]hp-fpm: master' lista os PHP-FPM ativos; com pacotes da distribuição, o caminho mostra a versão, como /etc/php/8.2/fpm/php-fpm.conf. Se houver mais de um, vale o do fastcgi_pass do nginx do site. O php -v mostra o PHP do terminal, usado pelo cron, que pode ser outro.
  2. Banco. SELECT VERSION(); dentro do banco. O mysql --version não serve de prova: mostra o programa cliente, que pode ser de outra versão.
  3. OpenSearch. curl -XGET https://localhost:9200 -u 'usuario:senha' --insecure, a verificação da documentação da Adobe. A versão vem no campo "number".
  4. Magento. bin/magento --version responde algo como Magento CLI 2.4.7-p10. Se ele falhar com o erro do Composer, isso já é prova; a versão também está no composer.lock.

Se a combinação atual não está na linha da versão da loja e a data da mudança bate com a primeira tela de erro, a causa está confirmada. O que copiar da tela antes de chamar alguém está em o que cada tela de erro do Magento significa.

Voltar a versão do PHP da loja Magento ou adaptar: como decidir

A regra que eu uso: primeiro a loja volta a vender, depois a adaptação é planejada e testada em homologação.

O que mudouVoltar é possível?O que pedirQuando adaptar a loja
PHPEm geral sim, se a versão anterior segue instaladavoltar o PHP-FPM do site e o PHP do cronquando a versão antiga saiu do plano: atualizar o Magento para uma linha que aceite o PHP novo
Banco com versão maiorDifícil: o MariaDB diz que voltar entre versões maiores não tem suporte oficialversão anterior e restauração de dump, conferindo os pedidos feitos depoisquando a versão nova já está na matriz da sua linha, num patch mais novo
OpenSearchPossível: o índice de busca é reconstruído a partir do bancoversão compatível e bin/magento indexer:reindex catalogsearch_fulltextquando a nova está na matriz: a 2.4.6-p15 e a 2.4.7-p10 aceitam OpenSearch 3

Às vezes adaptar é só subir de patch na mesma linha: pela matriz, a 2.4.7-p10 aceita MariaDB 11.8 e a 2.4.7-p9 não. Voltar a versão é trabalho da hospedagem, medido em horas; adaptar é projeto, com orçamento depois do levantamento. Quando a adaptação é grande, o checklist de servidor e loja para a 2.4.9 mostra o que levantar.

Modelo de pedido à hospedagem para voltar a versão

Mande pelo canal oficial de chamados e guarde o protocolo. Troque os campos em maiúsculas:

Assunto: loja fora do ar após mudança de versão em DD/MM

A loja WWW.SUALOJA.COM.BR roda Magento VERSÃO, suportado com PHP ANTERIOR. Após a manutenção de DD/MM, o site passou a usar PHP NOVO (evidência anexa) e está com erro desde HH:MM.

Solicito, com prioridade de loja parada: 1) voltar o PHP-FPM do site e o PHP do cron para o ANTERIOR; 2) confirmar por escrito as versões de PHP, banco e OpenSearch ativas; 3) informar até quando o ANTERIOR segue disponível no plano; 4) não mudar versão nesta conta sem aviso prévio por escrito.

Se não houver como voltar, peça a hora exata da mudança e o backup de antes dela: é com isso que se decide entre restaurar e adaptar.

Para não acontecer de novo: aviso prévio e congelamento até janeiro

Hospedagem atualiza versão porque precisa: PHP sem suporte de segurança é risco para todos os clientes dela. O que dá para negociar é o jeito. Eu recomendo três pontos no contrato:

  • Aviso prévio por escrito de mudança de versão de PHP, banco, OpenSearch, Valkey ou Redis e Varnish, com prazo para testar em homologação.
  • Versões fixadas por conta, com período de convivência em que a anterior segue disponível.
  • Janela combinada fora de data de campanha, com o contato de quem executa.

Para este fim de ano, peça já o congelamento de mudanças de versão na sua conta até a primeira semana de janeiro: a Black Friday cai em 27/11/2026 e o Natal vem logo depois. E anote que o PHP 8.2 perde o suporte de segurança em 31/12/2026; loja em 2.4.6 ou 2.4.7 nesse PHP precisa planejar a troca antes que ela chegue pela hospedagem.

Se a loja parou agora, veja o suporte técnico quando a loja cai e mande a versão do Magento, o aviso da hospedagem e o horário do primeiro erro.

Perguntas frequentes

A hospedagem pode voltar a versão do PHP da loja Magento?

Em geral, sim, se a versão anterior ainda está instalada: basta apontar o site e o PHP usado pelo cron de volta para ela. Se a hospedagem removeu a versão antiga, a saída é atualizar o Magento para uma linha que aceite o PHP novo, com teste em homologação.

A hospedagem mudou a versão do MySQL ou do MariaDB e a loja caiu. O que fazer?

Confirme com SELECT VERSION() e compare com a matriz da Adobe. Voltar um MariaDB de versão maior não tem suporte oficial: exige a versão anterior e restauração de dump, cuidando dos pedidos feitos depois. Às vezes é mais rápido levar a loja ao patch que já aceita a versão nova.

Como saber se a versão do PHP é incompatível com o Magento?

Compare o PHP que atende o site com a tabela de requisitos da Adobe para a versão exata da loja, mostrada por bin/magento --version. Mensagens como Deprecated Functionality ou Composer detected issues in your platform logo depois de uma troca de PHP são sinais fortes de incompatibilidade.

Por que a loja Magento deu erro depois da manutenção da hospedagem se ninguém mexeu no código?

Porque o código é o mesmo, mas o ambiente mudou. Uma versão nova de PHP pode tornar obsoleto um recurso que uma extensão usa, e o Magento trata esse aviso como erro e interrompe a página.

Fontes oficiais

  1. System requirements (Adobe Experience League)
  2. Supported Versions (PHP.net)
  3. Downgrading MariaDB (MariaDB)
  4. Search engine prerequisites (Adobe Experience League)

Outros artigos

Ver todos os artigos

Precisa de um orçamento? Ficarei feliz em ajudar. Clique aqui