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.

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
- Onde o Plesk decide quais versões de PHP o cliente vê
- Antes de esconder uma versão, descubra quem está nela
- Como limitar as versões no plano de serviço
- Como desativar uma versão no servidor
- Exceção para um cliente com a assinatura personalizada
- Checklist para padronizar em vários servidores
- 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.
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:
- Migre primeiro os sites listados na sua planilha para a versão de destino.
- Confira que nenhum site restou no handler antigo: rode de novo a contagem por
php_handler_ide o identificador antigo não deve aparecer. - 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.
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:
- A assinatura fica fora de sincronia. Mudanças futuras no plano não chegam nela até você sincronizar de novo, o que desfaz a personalização.
- Se o handler antigo estiver desativado no servidor, personalizar a assinatura não traz ele de volta. A exceção por cliente só funciona com handlers ativos.
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:
- Rodar
plesk bin php_handler --liste salvar a saída com a data. - Mapear quais domínios usam cada handler antigo com a consulta
plesk dbe salvar o resultado. - Ajustar o handler padrão em todos os planos de serviço.
- Revisar as permissões de PHP de cada plano.
- Migrar os sites, testando login do WordPress, formulários e o painel do cliente.
- Desativar o handler antigo só com uso zerado.
- Listar as assinaturas personalizadas e revisar uma vez por trimestre.
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
- Documentação oficial (plesk) — Plesk Onyx - guia do administrador. Consultado em 2026-11-12.