Como impedir que o cliente volte o site para PHP antigo
Como ocultar versões sem suporte do MultiPHP Manager na revenda, o que acontece com quem já estava nelas e como explicar isso ao cliente.

Resposta curta: o domínio que já estava rodando na versão oculta continua rodando nela, sem interrupção. O que o cliente perde é a opção: a versão some do seletor do MultiPHP Manager, então ele pode sair dela, mas não consegue mais voltar sozinho.
Neste artigo
- O que o cliente vê no MultiPHP Manager e o que ele consegue desfazer
- O que conferir no EasyApache 4 antes de esconder qualquer versão
- Como ocultar versões e marcar a recomendada em multiphp.conf
- O domínio que já rodava na versão oculta continua rodando nela
- Conferência numa conta real com PHP_VERSION
- Padronizar isso em vários sites de uma revenda
- Texto pronto para avisar o cliente que ainda roda 5.6
- Erros comuns e como reverter
O que o cliente vê no MultiPHP Manager e o que ele consegue desfazer
Na conta cPanel, Software » MultiPHP Manager lista os domínios do usuário e, ao lado de cada um, um seletor com as versões de PHP instaladas no servidor. O usuário final escolhe qualquer uma delas. Não existe confirmação, não existe log visível para ele, não existe aviso de que a versão escolhida saiu de suporte.
É por isso que a decisão que você tomou na migração (subir o site para PHP 8.x, ajustar o tema, trocar dois plugins) sobrevive até o dia em que o cliente vê um erro fatal, abre o MultiPHP Manager e volta para a 5.6 porque "antes funcionava".
O controle existe e fica do seu lado, na revenda: a documentação do cPanel descreve como limitar quais versões de PHP aparecem no MultiPHP Manager e qual delas é apresentada como recomendada (How to Limit Available PHP Versions in the MultiPHP Manager). O efeito prático é simples: versão oculta some do seletor do cliente, e some do seletor de todas as contas do servidor.
O que conferir no EasyApache 4 antes de esconder qualquer versão
Antes de esconder qualquer coisa, confira o estado real do servidor. Esconder a versão errada quebra site.
- Acesso root ou WHM de revenda com permissão para EasyApache 4 e MultiPHP Manager. Revenda sem root não altera a lista global de versões: nesse caso, quem precisa aplicar é o provedor.
- Saber quais pacotes
ea-phpXXestão instalados. A lista aparece em WHM » Software » EasyApache 4 e em WHM » Software » MultiPHP Manager. - Saber quais domínios estão em cada versão, antes da mudança. A mesma tela do MultiPHP Manager no WHM lista domínios por versão.
- Ter uma versão recomendada decidida. Não adianta ocultar a 5.6 sem ter um alvo claro para onde mover os sites presos nela.
- Conferir qual é a versão padrão do sistema em WHM » Software » MultiPHP Manager, aba de configurações de PHP do sistema. Se a padrão for justamente a que você vai ocultar, troque a padrão por uma versão suportada antes de ocultar. Caso contrário, toda conta nova nasce em uma versão que o dono dela não enxerga no seletor e não consegue trocar de volta.
- Janela de manutenção combinada, mesmo que a operação não derrube nada. Se você descobrir um site que só roda em 5.6, vai precisar de tempo para resolver.
Um detalhe que muda o planejamento: ocultar é uma configuração de servidor, não de conta. Não dá para esconder a 5.6 só para o cliente A e deixá-la visível para o cliente B na mesma máquina.
Como ocultar versões e marcar a recomendada em multiphp.conf
O procedimento documentado pelo cPanel é feito no servidor, como root, e define duas coisas: a lista de versões que não devem aparecer na interface e qual versão é exibida como recomendada aos usuários.
O arquivo é /var/cpanel/multiphp.conf, em JSON. Ele não existe por padrão: crie se precisar, com as duas chaves documentadas na página oficial:
hidden_versions: lista das versões que somem da interface, pelo nome do pacote (ea-php56,ea-php70).recommended_version: a versão exibida como recomendada ao usuário, também pelo nome do pacote.
{
"hidden_versions": ["ea-php56", "ea-php70"],
"recommended_version": "ea-php82"
}
Depois de salvar, recarregue o cpsrvd para a interface reler o arquivo:
/usr/local/cpanel/scripts/restartsrv_cpsrvd
Os nomes das chaves foram conferidos contra a documentação atual do cPanel & WHM. Se o seu servidor roda uma versão mais antiga, abra a mesma página antes de salvar e confirme a grafia: esse é o tipo de detalhe que muda entre versões, e chave errada falha em silêncio (o arquivo é lido, nada acontece).
Levante o inventário de domínio por versão antes de editar
Anote em um arquivo o estado atual, domínio por domínio. Se algo der errado, esse inventário é o seu rollback.
Valide na conta do cliente se a versão sumiu mesmo do seletor
Recarregue o MultiPHP Manager no WHM e, em seguida, entre em uma conta de teste pelo WHM e abra o MultiPHP Manager dela. A versão oculta não deve mais aparecer no seletor. Se ainda aparecer, o arquivo não foi lido: revise a sintaxe antes de mexer de novo.
Avise quem está na versão oculta antes de ele perceber sozinho
Avise os clientes que ainda têm domínio na versão oculta antes de eles descobrirem sozinhos. Isso evita o chamado em que a pessoa jura que o seletor "sumiu uma opção".
O domínio que já rodava na versão oculta continua rodando nela
Esta é a parte que ninguém responde em português, e é a mais importante para você planejar a migração.
Ocultar uma versão não troca a versão de ninguém. O domínio que já estava atribuído à 5.6 continua rodando em 5.6 depois de ela sumir da interface. O que o cliente perde é a opção: ele não consegue mais selecionar aquela versão para nenhum domínio, inclusive para um domínio que acabou de sair dela.
O efeito colateral é de mão única e vale ser dito em voz alta: se o cliente mover o site da versão oculta para a recomendada e o site quebrar, ele não consegue voltar sozinho. Quem reverte é você, e são dois caminhos diferentes: para devolver a opção ao cliente, tire a versão de hidden_versions em /var/cpanel/multiphp.conf como root e recarregue o cpsrvd; para resolver só aquele domínio sem reexibir nada, reatribua a versão em WHM » Software » MultiPHP Manager, que lista as versões instaladas mesmo as ocultas no cPanel do usuário.
| Cenário | O que acontece com o site | O que o cliente consegue fazer |
|---|---|---|
| Domínio já estava na versão oculta | Continua rodando nela, sem interrupção | Pode sair dela; não pode voltar |
| Domínio estava em versão visível | Nada muda | Troca livremente entre as visíveis |
| Conta nova criada depois | Nasce na versão padrão do servidor, que pode ser a oculta se você não trocou a padrão antes | Escolhe entre as visíveis |
| Cliente quer voltar para a oculta | Depende de você | Nada, a opção não existe mais |
Tradução operacional: ocultar a 5.6 congela o legado no lugar e impede novas adesões a ele. Não é migração. A migração continua sendo trabalho seu.
Conferência numa conta real com PHP_VERSION
Depois de aplicar, valide em uma conta de verdade, não só na tela do WHM. O teste mais barato é pedir ao próprio PHP qual versão ele é.
# no document root do domínio, via SSH ou Gerenciador de Arquivos
echo '<?php echo PHP_VERSION;' > versao-teste.php
curl -s https://exemplo.com.br/versao-teste.php; echo
rm versao-teste.php
Checklist de conferência, nesta ordem:
- O seletor do cliente mostra só as versões que você quer. Confirme entrando na conta, não no WHM.
- A versão marcada como recomendada é a que você decidiu.
- O domínio legado responde a mesma versão de antes no teste com
PHP_VERSION. - O site legado abre, faz login no wp-admin e salva um post. Página inicial que carrega não prova nada: o erro de versão costuma aparecer no admin e no checkout.
- O arquivo de teste foi removido.
Padronizar isso em vários sites de uma revenda
Se você administra uma revenda com dezenas de contas, trate como processo, não como tarefa avulsa.
- Inventário primeiro, política depois. Liste domínio, versão atual, CMS e plugin crítico. Sem isso você vai ocultar uma versão e descobrir o legado pelo telefone.
- Fila por risco, não por ordem alfabética. Comece pelos sites institucionais simples, termine pelos que têm integração de pagamento ou sistema sob medida.
- Uma versão oculta por vez. Oculte a mais antiga, espere alguns dias, repita. Esconder quatro versões no mesmo dia transforma qualquer problema em adivinhação.
- Deixe a recomendada explícita e repita o mesmo número em todos os seus servidores. Padronização reduz o tempo de diagnóstico quando o site de um cliente se comporta diferente do de outro.
- Documente a data de cada ocultação. Quando alguém perguntar "desde quando não dá para escolher 5.6", a resposta tem que ser uma data, não uma estimativa.
Texto pronto para avisar o cliente que ainda roda 5.6
Use em e-mail ou WhatsApp, adaptando o nome do sistema:
Três ajustes que costumam evitar discussão: diga que o site continua no ar (o medo imediato é esse), diga que a mudança é sobre correção de segurança, não sobre novidade, e ofereça uma data em vez de pedir uma decisão aberta.
Erros comuns e como reverter
- Ocultar a versão que o cliente usa sem avisar. Não quebra o site, mas gera a sensação de que você mexeu em algo escondido. Avise antes.
- Confundir ocultar com desinstalar. Remover o pacote
ea-phpXXno EasyApache 4 é outra operação, e essa sim derruba quem estava na versão. Ocultar é interface; desinstalar é execução. - Esquecer a recomendada. Sem ela, o cliente escolhe a primeira da lista, que pode não ser a sua escolha.
- Testar só a home. Valide wp-admin, formulário e checkout.
- Reverter. Reexibir é o caminho inverso do mesmo arquivo: remover a versão de
hidden_versionsem/var/cpanel/multiphp.conf, como root, e recarregar o cpsrvd. Trocar a versão de um domínio específico, sem reexibir para ninguém, é no WHM » Software » MultiPHP Manager. Faça isso quando precisar comprar tempo, não como solução: a versão continua sem correção de segurança no dia seguinte.
Se você não tem root na revenda, o pedido ao provedor cabe em duas linhas: quais versões ocultar no MultiPHP Manager e qual marcar como recomendada, citando a documentação do cPanel.
Referências
- Documentação oficial (cpanel) — How to Limit Available PHP Versions in the MultiPHP Manager. Consultado em 2026-10-16.