blog
Painéis

Como mudar a versão do PHP no Plesk e voltar se der erro

Um roteiro para quem não é técnico: anotar a versão atual, trocar pelo próprio painel, testar duas páginas e desfazer em segundos se algo quebrar. Com o texto pronto para o chamado quando a opção estiver bloqueada.

JR · · 7 min de leitura · 1 tabela · 2 blocos de código

Resposta curta: no Plesk, abra Sites e Domínios, entre em Configurações de PHP do domínio, anote a versão atual, escolha a nova e clique em OK. Teste a home e uma página interna em janela anônima; se quebrar, volte à versão anotada pelo mesmo caminho.

Neste artigo
  1. O que muda no seu site quando a versão de PHP é trocada
  2. Antes de começar: o que ter em mãos
  3. Passo a passo para trocar a versão de PHP no Plesk
  4. Como conferir se o site continua funcionando
  5. Como voltar à versão anterior no mesmo minuto
  6. Quando a opção de trocar a versão não aparece
  7. O que pedir ao desenvolvedor antes da troca

O que muda no seu site quando a versão de PHP é trocada

PHP é a linguagem em que roda boa parte dos sites com WordPress, lojas virtuais e sistemas feitos sob medida. Cada versão de PHP tem prazo de validade: depois de um tempo, ela para de receber correções de segurança. Os prazos de cada versão são públicos e ficam na página oficial de versões suportadas do PHP (php.net, seção Supported Versions). Vale consultar ali antes de escolher para qual versão ir, porque essa lista muda com o tempo. Um site rodando numa versão sem suporte continua no ar, mas fica exposto a falhas que ninguém mais vai corrigir.

Trocar a versão é uma mudança de configuração, não de conteúdo. Seus textos, fotos e pedidos continuam onde estão. O risco é outro: algum plugin ou tema antigo pode não funcionar na versão nova e a página aparece em branco ou com mensagem de erro. Por isso o procedimento abaixo tem três partes: trocar, conferir e, se algo quebrar, voltar na hora.

Se a sua hospedagem entrega o painel Plesk (painel de controle onde você gerencia sites, e-mails e domínios), a troca costuma estar disponível para você mesmo, sem depender do administrador do servidor. Os passos seguem a documentação oficial do Plesk para clientes, chamada Plesk Obsidian: Customer Guide. Não colocamos o link aqui porque o endereço que usamos como referência é um índice técnico em italiano, feito para programas de busca e não para leitura: quem clica vê código, não um guia. Se quiser consultar a fonte, procure pelo nome do guia no site docs.plesk.com. Os nomes dos menus podem variar um pouco conforme a versão do Plesk e o idioma escolhido.

Antes de começar: o que ter em mãos

Separar cinco minutos de preparação evita a parte mais desagradável, que é não saber para qual versão voltar.

Resultado esperado desta etapa: você sabe entrar no painel, tem duas páginas escolhidas e sabe que existe backup.

As três partes do procedimentoAntes de começarTrocar a versãoConferir o siteVoltar se algo quebrar
Ordem do procedimento: trocar, conferir as duas páginas e voltar se algo quebrar.

Passo a passo para trocar a versão de PHP no Plesk

Entre no painel e abra o site

Faça login no Plesk. No menu lateral, clique em Sites e Domínios (em inglês, *Websites & Domains*). Se você tem mais de um site na assinatura, localize o domínio que quer alterar.

Resultado esperado: você vê o cartão do seu domínio com atalhos como arquivos, banco de dados e configurações de hospedagem.

Abra as configurações de PHP

No cartão do domínio, procure o atalho Configurações de PHP (*PHP Settings*). Em algumas versões do Plesk, a própria versão em uso aparece como um link no painel do domínio, por exemplo "PHP 8.1", e clicar nela leva à mesma tela.

Resultado esperado: abre uma página com a versão de PHP atual no topo, seguida de uma lista longa de ajustes técnicos.

Anote a versão atual

Antes de mudar qualquer coisa, anote exatamente o que está selecionado no campo de versão do PHP e no campo logo abaixo, chamado manipulador (*handler*). O manipulador é a forma como o servidor executa o PHP, e costuma aparecer com nomes como "aplicativo FPM servido pelo nginx" ou "FastCGI". FPM, FastCGI e nginx são só nomes técnicos de programas e modos de execução do servidor. Você não precisa entender a diferença. Só precisa copiar o texto exatamente como aparece na tela, letra por letra, para conseguir voltar.

Resultado esperado: você tem anotados no papel a versão atual (por exemplo, "8.1") e o nome do manipulador, do jeito que estavam escritos.

Escolha a nova versão

No campo de versão, abra a lista e escolha a versão desejada. Só aparecem as versões que a sua hospedagem instalou no servidor. Não mexa no restante da página: os demais ajustes devem ficar como estão.

Resultado esperado: a lista se fecha e o campo mostra a nova versão selecionada. Nada mudou no site ainda, porque você não salvou.

Salve e confirme a nova versão no cartão do domínio

Role até o fim da página e clique em OK ou Aplicar. A troca vale em poucos segundos, sem reiniciar nada pelo seu lado.

Resultado esperado: o painel volta à tela anterior e a versão nova aparece no cartão do domínio.

Como conferir se o site continua funcionando

Abra o site numa janela anônima do navegador (no Chrome, Ctrl+Shift+N). Isso evita que você veja uma cópia guardada pelo navegador e ache que está tudo certo quando não está.

Confira, nesta ordem:

  1. A página inicial carrega por completo, com imagens e menu.
  2. A página interna que você escolheu abre normalmente.
  3. Se houver formulário ou carrinho, faça uma ação simples: adicionar um produto, enviar um contato de teste.
  4. Se o site tem área administrativa (o painel do WordPress, por exemplo), entre nela.
O que você vê O que costuma significar O que fazer
Tudo normal nas duas páginas A versão nova é compatível com o site Manter e avisar o desenvolvedor
Página totalmente em branco Algum plugin, tema ou código não roda na versão nova Voltar à versão anterior agora
Mensagem com "Fatal error" ou "erro crítico" Incompatibilidade de código Voltar agora e copiar o texto do erro para o desenvolvedor
Erro 500 Falha no servidor ao executar o site Voltar agora e abrir chamado
Home funciona, página interna ou carrinho não Incompatibilidade em uma parte específica, como um plugin de pagamento Voltar agora: carrinho quebrado é venda perdida
Avisos estranhos no topo da página, mas o site funciona Código antigo gerando alertas Pode manter por pouco tempo, mas peça revisão ao desenvolvedor

A regra é simples: se algo que dá dinheiro ou contato parou, volte primeiro e investigue depois.

Como voltar à versão anterior no mesmo minuto

Voltar é o mesmo caminho da troca, com a versão que você anotou.

  1. Em Sites e Domínios, abra de novo as Configurações de PHP do domínio.
  2. No campo de versão, selecione a versão anotada no passo 3.
  3. Se o manipulador também mudou, selecione o que estava antes.
  4. Clique em OK ou Aplicar.
  5. Recarregue a home e a página interna na janela anônima.

Resultado esperado: o site volta exatamente como estava. Se mesmo assim continuar com erro, o problema provavelmente não era a versão de PHP. Nesse caso, abra chamado com o suporte informando o horário da troca e o horário da volta.

Voltar não resolve o problema de fundo. O site segue numa versão que vai perder suporte, e alguém precisa atualizar o plugin, o tema ou o código incompatível. O próximo passo é conversar com o desenvolvedor.

Quando o site quebra depois da trocaPágina do site com erroVoltar para a versão anotadaSite funcionando de novo
Se algo que dá dinheiro ou contato parou, a volta vem antes da investigação.

Quando a opção de trocar a versão não aparece

No Plesk, o que o cliente pode ou não alterar é definido pela hospedagem no plano contratado. Se o atalho de Configurações de PHP não aparece, ou aparece com o campo de versão travado, o mais comum é que o plano não dê essa permissão à sua conta. Também pode acontecer de a versão que você quer não estar instalada no servidor e por isso não aparecer na lista.

Nenhuma das duas situações você resolve sozinho, e não precisa. Copie o texto abaixo, ajuste o que está entre colchetes e envie ao suporte da hospedagem:

Olá. Preciso alterar a versão de PHP do domínio [seudominio.com.br]
na minha assinatura do Plesk.

Versão atual: [ex.: PHP 8.1]
Versão desejada: [ex.: PHP 8.3]

No painel, em Sites e Domínios, [não aparece a opção Configurações de PHP /
o campo de versão está bloqueado / a versão desejada não está na lista].

Peço uma destas opções:
1. Liberar no meu plano a permissão para eu mesmo alterar a versão e o
   manipulador de PHP; ou
2. Fazer a troca por mim em horário combinado, mantendo a versão atual
   anotada para retorno imediato caso o site apresente erro.

Obrigado.

Pedir a permissão (opção 1) é melhor no longo prazo: na próxima troca, você não depende de ninguém e consegue voltar em segundos.

O que pedir ao desenvolvedor antes da troca

Se o site foi feito por terceiros, uma mensagem curta antes da troca economiza susto. O desenvolvedor sabe se os plugins e o tema já são compatíveis com a versão nova. Algo assim resolve:

Oi. A versão de PHP do site [seudominio.com.br] está perto do fim
do suporte de segurança e quero trocar para [ex.: PHP 8.3] pelo Plesk.
Você consegue confirmar se o tema, os plugins e o código do site são
compatíveis? Se não forem, qual seria o trabalho e o prazo para ajustar?

Se o desenvolvedor não responder ou não existir mais, o procedimento deste guia continua válido: trocar em horário calmo, conferir as duas páginas e voltar se algo quebrar. O teste em si leva poucos minutos e não apaga nada. O que você ganha é saber, com o site real, se a versão nova funciona ou se é preciso contratar um ajuste antes que a versão atual perca o suporte.

Referências

  1. Documentação oficial (plesk) — Plesk Obsidian: Customer Guide. Consultado em 2026-11-12.
Leia também