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 loja | PHP | Banco | OpenSearch |
|---|---|---|---|
| 2.4.9 | 8.5 | MariaDB 12.3 ou MySQL 8.4 | 3 |
| 2.4.8-p5 | 8.4 ou 8.3 | MariaDB 11.4 ou 11.8, MySQL 8.4 | 3 |
| 2.4.7-p10 | 8.3 ou 8.2 | MariaDB 10.11 ou 11.8 | 2.19 ou 3 |
| 2.4.6-p15 | 8.2 ou 8.1 | MariaDB 10.11 | 2.19 ou 3 |
| 2.4.5-p17 e 2.4.4-p18 | 8.1 | MariaDB 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:
- 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 dofastcgi_passdo nginx do site. Ophp -vmostra o PHP do terminal, usado pelo cron, que pode ser outro. - Banco.
SELECT VERSION();dentro do banco. Omysql --versionnão serve de prova: mostra o programa cliente, que pode ser de outra versão. - 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". - Magento.
bin/magento --versionresponde algo comoMagento CLI 2.4.7-p10. Se ele falhar com o erro do Composer, isso já é prova; a versão também está nocomposer.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 mudou | Voltar é possível? | O que pedir | Quando adaptar a loja |
|---|---|---|---|
| PHP | Em geral sim, se a versão anterior segue instalada | voltar o PHP-FPM do site e o PHP do cron | quando a versão antiga saiu do plano: atualizar o Magento para uma linha que aceite o PHP novo |
| Banco com versão maior | Difícil: o MariaDB diz que voltar entre versões maiores não tem suporte oficial | versão anterior e restauração de dump, conferindo os pedidos feitos depois | quando a versão nova já está na matriz da sua linha, num patch mais novo |
| OpenSearch | Possível: o índice de busca é reconstruído a partir do banco | versão compatível e bin/magento indexer:reindex catalogsearch_fulltext | quando 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
- System requirements (Adobe Experience League)
- Supported Versions (PHP.net)
- Downgrading MariaDB (MariaDB)
- Search engine prerequisites (Adobe Experience League)