Guia

Mude a versão do PHP de uma loja Magento 2, em segurança.

Confirme que a loja e as suas extensões aceitam a nova versão do PHP, aponte o nginx e a linha de comandos para ela, recompile e teste antes que alguém repare. Checked on 5 de nov. de 2026.

Step 1Verificar

Veja que versões do PHP o seu Magento suporta

Cada versão do Magento suporta duas versões do PHP: 8.3 e 8.4 para a 2.4.8, 8.2 e 8.3 para a 2.4.7. Veja o guia de requisitos para a tabela completa.

On your server

bin/magento --version
php -v

Step 2Verificar

Pergunte ao Composer se as extensões concordam

O Composer diz-lhe que pacotes bloqueariam a nova versão, antes de alterar o que quer que seja no servidor.

On your server

composer why-not php 8.3
composer check-platform-reqs

Se o why-not não mostrar nada, nada no composer.lock bloqueia o PHP 8.3.

Step 3Mudança

Aponte o nginx para o novo PHP-FPM

O nginx passa os pedidos PHP a um socket do PHP-FPM. Mude-o para o socket da nova versão, teste a configuração e recarregue. O caminho abaixo é o que o Debian e o Ubuntu usam.

nginx

# in the store's nginx server block
fastcgi_pass unix:/run/php/php8.3-fpm.sock;

nginx -t && systemctl reload nginx

Step 4Mudança

Use a mesma versão na linha de comandos

O cron e o bin/magento têm de correr com o mesmo PHP que o servidor web, ou comportam-se de forma diferente.

On your server

update-alternatives --set php /usr/bin/php8.3
php -v

Step 5Desenvolvimento

Recompile e teste

Recompile e faça o deploy dos ficheiros estáticos com o novo PHP, limpe a cache e acompanhe os registos enquanto percorre a loja e o checkout.

On your server

bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush
tail -f var/log/exception.log

Experimente primeiro numa cópia de staging: uma extensão com problemas aparece lá, não à frente dos clientes.

Perguntas, respondidas.

Suporte ShopWhizzy Magento desde 2008

Fale connosco
Sim. Cada versão tem o seu próprio serviço PHP-FPM, e cada site aponta para aquele de que precisa.
Cada versão do PHP tem as suas próprias extensões. Instale as que o Magento precisa para a nova versão, como intl, soap, bcmath, gd e zip, antes de mudar.
Aponte de novo o nginx e a linha de comandos para a versão antiga e recompile. Mantenha o PHP-FPM antigo instalado até ter a certeza.
Sim. Diga-nos a versão, e testamo-la em staging e mudamos a loja em produção por si.

Traga a sua loja. Mudamo-la de graça.

Escolha um plano, escolha uma plataforma, e a sua loja fica online antes de o café arrefecer.

Os preços incluem IVA. Suporte ao servidor em todos os planos.