blog
Revenda

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.

JR · · 8 min de leitura · 1 tabela · 3 blocos de código

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
  1. O que o cliente vê no MultiPHP Manager e o que ele consegue desfazer
  2. O que conferir no EasyApache 4 antes de esconder qualquer versão
  3. Como ocultar versões e marcar a recomendada em multiphp.conf
  4. O domínio que já rodava na versão oculta continua rodando nela
  5. Conferência numa conta real com PHP_VERSION
  6. Padronizar isso em vários sites de uma revenda
  7. Texto pronto para avisar o cliente que ainda roda 5.6
  8. 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.

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": ["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".

Ordem para ocultar uma versão de PHPInventárioDomínio, versão atual, CMSTrocar padrãoPadrão do sistema em versão suportadaEditar multiphp.confhidden_versions e recommended_versionRecarregar cpsrvdInterface relê o arquivoValidar na contaSeletor do cliente, não o WHM
Ordem de execução. Trocar a versão padrão antes de ocultar evita conta nova presa em versão invisível.

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.

O que acontece depois de ocultar a versãoVersão sumiu do seletor do clienteDomínio legado continua rodando nelaCliente move para a recomendadaSite quebrou? Ele não volta sozinhoVocê reatribui no WHM, sem reexibirOu remove de hidden_versions e recarrega
Ocultar congela o legado e impede novas adesões. A reversão é sempre 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:

  1. O seletor do cliente mostra só as versões que você quer. Confirme entrando na conta, não no WHM.
  2. A versão marcada como recomendada é a que você decidiu.
  3. O domínio legado responde a mesma versão de antes no teste com PHP_VERSION.
  4. 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.
  5. 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.

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

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

  1. Documentação oficial (cpanel) — How to Limit Available PHP Versions in the MultiPHP Manager. Consultado em 2026-10-16.
Leia também