# 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.

> 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.

João Rizzon · 2026-11-13 · Painéis

---

## 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.

- **Login do Plesk**: o endereço do painel, usuário e senha. Costuma vir no e-mail de boas-vindas da hospedagem.
- **Um backup recente**: o Plesk tem uma área de backup na própria assinatura. No Plesk, "assinatura" não é cobrança nem mensalidade: é o nome que o painel dá ao conjunto de site, e-mails e recursos do seu plano. Se você não sabe usar o backup, peça ao desenvolvedor ou ao suporte para confirmar que existe uma cópia de hoje.
- **Duas páginas para testar**: a página inicial e uma página interna importante. Numa loja, a página de um produto ou o carrinho. Num site institucional, a página de contato com formulário.
- **Um horário calmo**: de preferência fora do pico de vendas ou de visitas.
- **Papel ou bloco de notas aberto**: você vai anotar a versão atual antes de mexer.

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

## 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:

- A página inicial carrega por completo, com imagens e menu.
- A página interna que você escolheu abre normalmente.
- Se houver formulário ou carrinho, faça uma ação simples: adicionar um produto, enviar um contato de teste.
- 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.

- Em **Sites e Domínios**, abra de novo as **Configurações de PHP** do domínio.
- No campo de versão, selecione a versão anotada no passo 3.
- Se o manipulador também mudou, selecione o que estava antes.
- Clique em **OK** ou **Aplicar**.
- 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 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.

