blog
Painéis

Como limitar as versões de PHP do cliente no Plesk

Onde ficam as versões e o modo de execução no plano e na assinatura, como esconder uma versão antiga sem derrubar quem ainda está nela e como abrir exceção para um cliente específico.

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

Resposta curta: no Plesk a escolha de PHP passa por três camadas: o servidor define quais handlers (versão e modo de execução) ficam ativos em Configurações PHP; o plano define o handler padrão e se o cliente pode trocar; e a assinatura personalizada abre exceção para um cliente específico.

Neste artigo
  1. Onde o Plesk decide quais versões de PHP o cliente vê
  2. Antes de esconder uma versão, descubra quem está nela
  3. Como limitar as versões no plano de serviço
  4. Como desativar uma versão no servidor
  5. Exceção para um cliente com a assinatura personalizada
  6. Checklist para padronizar em vários servidores
  7. O que dizer ao cliente quando a versão de PHP muda

Onde o Plesk decide quais versões de PHP o cliente vê

No cPanel, quem controla a lista é o MultiPHP Manager no WHM, com as versões instaladas pelo EasyApache. No Plesk a lógica é outra: o PHP chega ao site como um handler (a combinação de versão e modo de execução, por exemplo PHP-FPM servido pelo nginx ou FastCGI servido pelo Apache), e a escolha passa por três camadas.

Camada Onde fica no painel O que controla
Servidor Ferramentas e Configurações > Configurações PHP Quais handlers existem e estão ativos no servidor inteiro
Plano de serviço Planos de Serviço > (plano) > Parâmetros de Hospedagem e Permissões Handler padrão das assinaturas e se o cliente pode mexer nas configurações de PHP
Assinatura Assinaturas > (assinatura) > Personalizar Exceção para um cliente específico, que deixa a assinatura fora de sincronia com o plano

Os nomes dos menus seguem o guia do administrador do Plesk Onyx. Em versões mais novas do painel os rótulos podem mudar um pouco, mas a divisão em servidor, plano e assinatura continua a mesma.

A consequência prática: limitar versões no Plesk não é um único botão. Você decide o que existe no servidor e, depois, quem pode escolher dentro do que existe.

Antes de esconder uma versão, descubra quem está nela

O erro caro é desativar um handler e descobrir pelo telefone que três clientes estavam nele. Antes de qualquer mudança, liste os handlers do servidor pela linha de comando:

plesk bin php_handler --list

A saída mostra o identificador de cada handler, a versão do PHP e o tipo (FPM, FastCGI, CGI). Guarde esse identificador: é ele que aparece na configuração de hospedagem de cada site.

Na interface, a tela Ferramentas e Configurações > Configurações PHP mostra os handlers com o estado de cada um e indica o uso pelos sites. Se a sua versão do painel mostra a contagem de sites por handler, clique nela antes de desativar: você recebe a lista de domínios que vão ser afetados.

Monte uma planilha simples com três colunas: domínio, handler atual, versão de destino. Essa planilha vira o seu plano de migração e o seu registro para o cliente.

Se a tela não mostra a contagem, consulte o banco do painel. O plesk db abre o banco interno do Plesk e não depende da interface:

plesk db "SELECT d.name, h.php_handler_id FROM domains d JOIN hosting h ON h.dom_id = d.id ORDER BY h.php_handler_id"

A saída é uma tabela no formato do MySQL (exemplo ilustrativo):

+------------------+-----------------+
| name             | php_handler_id  |
+------------------+-----------------+
| cliente-a.com.br | plesk-php74-fpm |
| cliente-b.com.br | plesk-php82-fpm |
+------------------+-----------------+

Os valores de php_handler_id são os mesmos identificadores do php_handler --list. Para validar, conte os sites por handler e compare com o número de linhas da planilha:

plesk db "SELECT php_handler_id, COUNT(*) FROM hosting GROUP BY php_handler_id"

Se a consulta der erro de coluna, rode plesk db "DESCRIBE hosting" e confira o nome do campo na sua versão. A consulta é só leitura e não altera nada.

Como limitar as versões no plano de serviço

O plano é onde a padronização rende, porque uma mudança nele propaga para todas as assinaturas sincronizadas.

Defina o handler padrão do plano

Em Planos de Serviço, abra o plano e vá em Parâmetros de Hospedagem. Na área de suporte a PHP, escolha a versão e o modo de execução do plano. Esse handler vale para novas assinaturas e também para as existentes que seguem o plano, assim que você sincronizar (passo 3). Prefira uma versão com suporte ativo do projeto PHP e o modo FPM quando o servidor oferece.

Decida se o cliente pode trocar de versão

Na aba Permissões do plano ficam as permissões ligadas à hospedagem e às configurações de PHP. Se o cliente tem permissão de gerenciar as configurações de hospedagem, ele consegue escolher outra versão dentre as ativas no servidor. Se você retira essa permissão, ele vê a configuração mas não altera. Os rótulos exatos variam entre versões do painel; procure os itens de gerenciamento de configurações de hospedagem e de configurações de PHP.

Sincronize e confira antes de aplicar

Ao usar Atualizar e sincronizar, o Plesk aplica a mudança a todas as assinaturas que seguem o plano. Isso inclui trocar o PHP de sites em produção. Antes de sincronizar, cruze a lista de assinaturas do plano com a sua planilha: todo site que ainda não foi testado na versão nova vai mudar junto. Se houver dúvida, crie um plano de teste com uma única assinatura isolada, sincronize nele primeiro e confirme que o handler e as permissões ficaram como esperado e que o site responde.

Um ponto que pega muita agência: o plano não tem uma caixa do tipo "esta versão sim, aquela não" só para os clientes dele. Ou o cliente pode escolher entre os handlers ativos no servidor, ou não pode escolher. Para tirar uma versão do cardápio de todo mundo, o lugar é a camada do servidor.

Sequência para mudar o PHP pelo planoDefinir handler no planoVersão e modo de execução padrãoRevisar permissõesQuem pode trocar a versãoTestar em plano isoladoUma única assinatura de testeSincronizar o planoSó depois dos testes
Ordem para ajustar o PHP pelo plano sem afetar sites não testados.

Como desativar uma versão no servidor

Em Ferramentas e Configurações > Configurações PHP, selecione o handler da versão antiga e use a opção de desativar. Depois disso ele deixa de aparecer como escolha nas configurações de hospedagem.

O efeito sobre o site que ainda está nesse handler é a parte que exige cuidado, e o comportamento pode variar entre versões do Plesk. Não vou afirmar o que acontece em todas as versões porque não testei; a regra segura é esta:

  1. Migre primeiro os sites listados na sua planilha para a versão de destino.
  2. Confira que nenhum site restou no handler antigo: rode de novo a contagem por php_handler_id e o identificador antigo não deve aparecer.
  3. Só então desative.

Se precisar desativar com um site ainda na versão antiga, faça antes num servidor ou site de homologação e observe: o site continua respondendo, cai para outro handler ou apresenta erro. Esse teste leva minutos e evita descobrir em produção.

Desativar não é desinstalar. O pacote continua no servidor e você pode reativar o handler se precisar de rollback. Remover o pacote do PHP é outro passo, feito pelo instalador de componentes do Plesk, e só vale quando você tem certeza de que nada depende dele.

Antes de desativar um handler antigoHá sites no handler antigo?Consulte por php_handler_idMigrar os sites listadosUse a planilha como planoContagem zerada?Confirme antes de seguirDesativar o handlerEle deixa de aparecer como escolhaManter o pacote instaladoPermite rollback pela reativação
Decisão antes de desativar uma versão no servidor.

Exceção para um cliente com a assinatura personalizada

Tem cliente com sistema legado que não roda em versão nova e não vai ser reescrito este mês. Para ele, abra a assinatura e use Personalizar. A assinatura passa a ter configuração própria, desvinculada do plano.

Duas consequências que você precisa registrar:

Na prática, para manter um cliente em versão antiga você precisa manter o handler ativo no servidor. Com ele ativo, qualquer cliente com permissão de troca de PHP também consegue escolhê-lo. A forma de impedir isso é retirar essa permissão dos outros planos, e essa é uma decisão a pesar: todos os clientes desses planos deixam de trocar de versão sozinhos, e se a permissão retirada for a de configurações de hospedagem, eles podem perder também o controle de outros itens dessa tela. A alternativa é manter a permissão e aceitar que alguém escolha a versão antiga, monitorando com a consulta por handler. Em qualquer caso, anote a data e o motivo da exceção na própria planilha.

Checklist para padronizar em vários servidores

Se você administra mais de um servidor Plesk, repita o mesmo roteiro em cada um:

No WordPress, antes de migrar, olhe o painel de Saúde do Site e a versão mínima declarada pelos plugins. Plugin abandonado é um motivo frequente de um site não subir em versão nova, e isso se resolve trocando o plugin, não segurando o PHP.

O que dizer ao cliente quando a versão de PHP muda

O cliente não quer saber de handler. Ele quer saber se o site vai sair do ar e por que você mexeu. Uma frase que funciona:

"A versão de PHP que o seu site usava deixou de receber correções de segurança do projeto oficial. Migramos para uma versão suportada, testamos o site e removemos a opção antiga do painel para que ninguém volte para ela por engano."

Se ele tiver o sistema legado que exige versão antiga, seja direto: a exceção existe, mas tem prazo e ele precisa de orçamento para atualizar o código. Deixar isso por escrito protege você quando o site for invadido por uma falha que já tinha correção.

Referências

  1. Documentação oficial (plesk) — Plesk Onyx - guia do administrador. Consultado em 2026-11-12.
Leia também