Qual a diferença entre patch e upgrade no Magento
Parte da confusão vem do vocabulário da própria Adobe. Na política de versões dela, 2.4 é uma versão menor (minor), 2.4.8 é uma patch release e 2.4.8-p1 é uma security patch release. Ou seja: no idioma da Adobe, a 2.4.9 também é um "patch". Na conversa com o lojista, eu chamo de upgrade a troca de linha (da 2.4.8 para a 2.4.9) e de patch o que corrige a linha em que a loja já está.
A distinção muda a proposta. A 2.4.9 pede PHP 8.5 na tabela de requisitos da Adobe, enquanto a 2.4.8 roda em 8.3 ou 8.4: upgrade mexe em servidor, extensões e tema e vira projeto. Patch costuma caber na manutenção, desde que a loja esteja em dia com a própria linha. Quando a proposta disser só "aplicar patch", peça o nome exato do que vai ser aplicado.
O que significa 2.4.8-p5
O sufixo -pN marca uma security patch release: a linha 2.4.8 com o N-ésimo pacote de segurança. Pela definição da Adobe, cada -pN é construída sobre a versão completa anterior, acumula as correções de segurança lançadas desde então e pode trazer hotfixes e mudanças de conformidade que quebram compatibilidade. Até a matriz testada muda: da 2.4.8-p4 para a p5, a tabela de requisitos on-premises passou o RabbitMQ de 4.1 para 4.3, o Valkey de 8 para 8.1 e o Varnish de 7.7 para 8, com o PHP igual. Por isso -pN pede homologação.
As datas ficam na página de versões lançadas da Adobe: a 2.4.8-p5 e a 2.4.7-p10 saíram em 12/05/2026, no mesmo dia da 2.4.9. Para saber em que ponto a sua loja está:
bin/magento --version
composer show magento/product-community-editionO primeiro responde algo como Magento CLI 2.4.8-p4. O segundo vale para o Magento Open Source; no Adobe Commerce, o pacote é magento/product-enterprise-edition.
Os 5 tipos de atualização do Magento lado a lado
| Tipo | O que é | Como chega | Esforço e risco (minha leitura) | Quando escolher |
|---|---|---|---|---|
| Hotfix | correção de alto impacto para falha crítica, como dia zero; pode ter mudança incompatível | Adobe, pela Quality Patches Tool; entra na próxima versão planejada | esforço baixo, risco médio | falha crítica publicada, em versão suportada, mesmo fora do último -p |
| Patch isolado de segurança | arquivo avulso e não cumulativo, só com correção de segurança | Adobe, com detalhes no boletim e instruções na base de conhecimento | baixo no último -p; alto fora dele | fechar falha entre uma versão -pN e outra |
| Versão -pN | pacote cumulativo de segurança na mesma linha | Adobe, pelo Composer | médio, com homologação | rotina, a cada -pN nova da sua linha |
| Quality patch | correção pontual de bug, de baixo impacto e sem mudança incompatível | Adobe e comunidade, pela Quality Patches Tool | baixo, aplicado um por vez | bug específico que já tem patch catalogado |
| Nova versão 2.4.x | nova linha, com correções, recursos e requisitos novos | Adobe, uma por ano, em maio | alto: levantamento, homologação e rollback | linha perto do fim do suporte ou recurso que só existe na nova |
Pela política de ciclo de vida, o hotfix de falha crítica sai para toda versão suportada, mesmo fora do último patch, mas a Adobe avisa que ele não resolve tudo o que a atualização resolveria.
Patch isolado do Adobe Commerce: por que ele exige o último -p
A Adobe testa cada patch isolado só contra a última versão -p de cada linha, e por isso exige que a loja esteja nela para aplicar. O calendário de 2026 publicado pela Adobe mostra por que isso pesa: as versões -pN saíram em março e em maio; para julho, agosto, setembro e outubro, o calendário previa arquivos de patch isolado para as linhas 2.4.4 a 2.4.9; para novembro e dezembro, liberação opcional, por causa do congelamento de código de fim de ano.
Exemplo: uma loja parada na 2.4.8-p4 não aplica o patch isolado feito para a 2.4.8-p5. Antes, precisa subir para a p5, com homologação. O que seria uma tarde de trabalho vira um pequeno projeto, justamente quando há falha de segurança publicada. Estar no último -p da linha é o que mantém o patch isolado barato.
Quality Patches Tool vale a pena?
Vale para um problema específico que já tem correção catalogada, e só para isso. A ferramenta é um pacote Composer da Adobe que lista, aplica e reverte patches individuais para a versão instalada, no Adobe Commerce e no Magento Open Source:
composer require magento/quality-patches
./vendor/bin/magento-patches statusTrês cuidados que eu cobro de quem aplica:
- Poucos patches. A própria Adobe desaconselha aplicar grande quantidade, porque o código fica mais complexo e a próxima atualização fica mais difícil.
- Lista dos aplicados guardada fora do servidor. Depois de um upgrade, o que não entrou na versão nova precisa ser reaplicado.
- Registro. A ferramenta grava as operações em
var/log/patch.log, que entra no relatório da manutenção.
Quality patch não substitui upgrade: a Adobe diz que a ferramenta serve para correções caso a caso, e não como estratégia de manutenção de longo prazo.
Atualizar patch sem mudar a versão do Magento: qual pedir agora
- Boletim de segurança com a sua versão na lista? No último -p, peça o patch isolado ou o hotfix; fora dele, peça antes a atualização para o último -p. O prazo de cada boletim está em boletim de segurança da Adobe: aplicar hoje ou esperar.
- Saiu -pN nova da sua linha? Agende na manutenção, com homologação.
- Bug específico atrapalhando a operação? Peça para procurar o quality patch antes de orçar correção sob medida.
- Linha perto do fim do suporte ou recurso novo necessário? Aí é upgrade, e o ponto de partida é o checklist para atualizar o Magento para a 2.4.9.
Em qualquer proposta, peça três linhas escritas: o nome exato do que será aplicado, a versão antes e depois e o roteiro de teste. Os prazos de suporte de cada linha estão em versões e prazos do Magento 2.
Perguntas frequentes
O que significa 2.4.8-p5 no Magento?
É a quinta security patch release da linha 2.4.8: a versão 2.4.8 com um pacote cumulativo de correções de segurança. Pela página de versões da Adobe, ela saiu em 12/05/2026. Como pode trazer mudanças de conformidade que quebram compatibilidade, precisa passar por homologação.
O que é security patch no Magento?
É a versão com o sufixo -pN, que junta correções de segurança sobre a versão completa anterior, sem os recursos de uma versão nova. Ela mantém a loja na mesma linha, como a 2.4.8, e é o caminho padrão para continuar protegido entre um upgrade e outro.
Quality Patches Tool vale a pena?
Vale para corrigir um bug específico que já tem patch catalogado pela Adobe ou pela comunidade, sem esperar uma versão nova. Não vale como estratégia: a Adobe desaconselha aplicar muitos patches, porque isso complica o código e encarece a próxima atualização.
Dá para atualizar o patch sem mudar a versão do Magento?
Dá. Subir da 2.4.8-p4 para a 2.4.8-p5, aplicar um patch isolado ou um hotfix mantém a loja na linha 2.4.8. Só a troca para outra linha, como a 2.4.9, é upgrade. Mesmo dentro da linha, a versão -pN pede homologação antes de ir para produção.
Fontes oficiais
- Released versions (Adobe Experience League)
- Adobe Commerce release policy (Adobe Experience League)
- Patch release schedule (Adobe Experience League)
- Adobe Commerce lifecycle policy (Adobe Experience League)
- Quality Patches Tool: a self-service tool for quality patches (Adobe Experience League)
- Quality Patches Tool: usage (Adobe Experience League)
- System requirements (Adobe Experience League)