Quais sites do cliente estão com PHP sem suporte
Como cruzar a listagem de contas do WHM com o MultiPHP Manager, marcar a versão recomendada no servidor e virar isso em cronograma de migração por cliente.

Resposta curta: não existe relatório pronto no WHM; você monta o inventário cruzando a lista de contas (listaccts) com as versões por vhost do MultiPHP Manager, registra a data de fim de suporte de cada versão na fonte do projeto PHP e usa a recomendação de versão do cPanel para o próprio painel do cliente sinalizar.
Neste artigo
- As quatro perguntas que o inventário precisa responder
- Como tirar a lista de domínios e versões do WHM
- Seis colunas que bastam, e a única que não sai do cPanel
- Fazer o painel do cliente avisar que a versão está velha
- Ordenar por data de fim de suporte e fechar as janelas
- O aviso pronto para mandar ao cliente, com data e responsável
- Checklist trimestral para refazer o inventário
As quatro perguntas que o inventário precisa responder
Revenda com dezenas de contas tem um problema chato: ninguém sabe de cabeça em que versão de PHP cada site está. O MultiPHP Manager do WHM mostra tudo, mas mostra por domínio, numa lista que rola, sem filtro por versão e sem contexto de quem é o cliente dono daquilo.
O inventário útil responde quatro perguntas, nesta ordem:
- Quais domínios rodam qual versão de PHP hoje.
- Quais dessas versões ainda recebem correção de segurança do projeto PHP.
- Quem é o cliente responsável por cada domínio e quem paga a migração.
- Em que semana cada migração entra na agenda.
Tudo o que não responde uma dessas quatro perguntas é enfeite na planilha e você vai parar de atualizar no segundo mês.
Como tirar a lista de domínios e versões do WHM
O caminho de interface é WHM → Software → MultiPHP Manager. A aba de domínios lista cada vhost com a versão aplicada e indica quando o domínio está usando a versão padrão do sistema em vez de uma versão fixada. Dá para copiar a tabela para a planilha, mas em servidor com muitas contas isso é trabalho manual repetido todo trimestre.
Por linha de comando, você junta duas informações: a lista de contas (usuário, domínio principal, plano, e-mail de contato) e a versão de PHP por vhost.
# contas da revenda, com usuário, domínio e contato
whmapi1 listaccts --output=jsonpretty \
| jq -r '.data.acct[] | [.user,.domain,.plan,.email] | @tsv' \
> contas.tsv
A versão por vhost também sai pela API do WHM, mas o nome exato da função e dos campos de retorno mudou entre gerações do cPanel. Em vez de colar um comando que pode não existir na sua build, abra WHM → Development → API Shell, procure a função de versões de PHP por vhost, rode uma vez pela interface e só depois transforme no comando do seu script. Custa pouco tempo e evita um jq que falha em silêncio e te entrega planilha vazia.
Se você administra mais de um servidor, gere um arquivo por servidor e acrescente uma coluna servidor antes de juntar tudo. Planilha única com coluna de origem é muito mais fácil de manter do que cinco abas.
Seis colunas que bastam, e a única que não sai do cPanel
Seis colunas essenciais mais duas de controle resolvem. Mais do que isso vira formulário.
| Coluna | Conteúdo | De onde vem |
|---|---|---|
| servidor | apelido do host | você define |
| conta | usuário cPanel | listaccts |
| dominio | vhost (inclui addon e subdomínio) | MultiPHP Manager |
| php_atual | ex.: ea-php74, ea-php82 |
MultiPHP Manager |
| suporte_ate | data de fim de suporte de segurança daquela versão | você consulta na página de versões suportadas do projeto PHP |
| cliente / contato | nome e e-mail de quem decide | listaccts + seu CRM |
| janela | semana planejada da migração | você define |
| status | pendente, avisado, migrado, travado | você atualiza |
A coluna suporte_ate é a que dá sentido a todas as outras, e é a única que não sai do cPanel. A documentação do cPanel trata de como o painel exibe recomendação de versão, não publica calendário de fim de vida do PHP. Não reproduzo datas aqui: consulte você mesmo a página de versões suportadas mantida pelo projeto PHP, anote a data que você leu e a data da consulta numa célula de nota. No trimestre seguinte você confere se mudou alguma coisa em vez de recomeçar.
Um detalhe que custa retrabalho: addon domains e subdomínios têm vhost próprio no MultiPHP Manager e podem estar em versão diferente do domínio principal. Se a sua extração listou só o domínio principal da conta, o inventário está incompleto e você vai descobrir isso no pior momento, quando o site institucional migrar e o /blog em addon quebrar.
Fazer o painel do cliente avisar que a versão está velha
O cPanel permite que o administrador do servidor defina recomendações de versão de PHP, de modo que o MultiPHP Manager dentro do painel do cliente sinalize que a versão em uso não é a aconselhada. O procedimento, o caminho do arquivo e o formato aceito estão em How to Set PHP Version Recommendations, na documentação do cPanel.
Não reproduzo aqui o caminho do arquivo nem o esquema campo a campo de propósito: eles variam entre releases, e recomendação copiada de blog velho resulta em arquivo que o painel simplesmente ignora, sem erro visível. Abra a página da documentação, confira se ela corresponde à sua versão de cPanel e copie de lá.
O que vale planejar antes de escrever o arquivo:
- Texto da recomendação. É o que o cliente vai ler. Escreva uma frase que ele entenda sozinho, com um canal de contato, não jargão de versão.
- Escopo. Recomendação é por servidor. Se você tem clientes com perfis muito diferentes no mesmo host, o texto precisa servir para todos.
- Ordem das operações. Publique a recomendação depois de ter o inventário pronto, não antes. Se o cliente abrir o painel, vir o aviso e te procurar, você precisa já saber o que responder sobre o site dele.
O que conferir numa conta real depois de aplicar a recomendação
Depois de aplicar, valide entrando numa conta de verdade, de preferência uma sua ou uma conta de teste: WHM → List Accounts → ícone de login como usuário, depois MultiPHP Manager dentro do cPanel do cliente.
O rótulo exibido, a posição da marcação na tabela e a presença de um ícone ou de texto ao lado da versão mudam entre releases. Não confie em print de blog ou de tutorial antigo: olhe a sua instalação, tire o seu print e guarde na pasta do procedimento interno. Esse print é o que você manda para o cliente quando ele diz que não está vendo aviso nenhum.
Se nada aparecer, o problema costuma ser um destes três: arquivo em caminho ou formato que a sua versão não lê, versão já em uso sendo justamente a recomendada (nada a sinalizar) ou cache do painel, que resolve com logout e login limpo.
Ordenar por data de fim de suporte e fechar as janelas
Ordene a planilha por suporte_ate crescente e depois por cliente. Quem está mais longe de receber correção vai primeiro. Dentro do mesmo cliente, agrupe: migrar os cinco sites de uma agência parceira na mesma semana é mais barato que espalhar em cinco semanas.
Regras que funcionam bem numa operação de revenda:
- Uma janela por semana, com no máximo o número de sites que você consegue reverter no mesmo dia se der errado.
- Site de e-commerce e site com integração de pagamento nunca na sexta.
- Antes de trocar, backup da conta e nota do valor anterior de
php_atualna planilha. Reverter é mudar de volta no MultiPHP Manager, mas só se você souber para onde voltar. - Depois de trocar, abrir o site logado e deslogado, testar formulário de contato e checkout, e olhar o log de erro da conta. Erro de PHP novo aparece em minutos, não em semanas.
- Status
travadoé legítimo: tema ou plugin abandonado que não roda na versão nova. Esse caso vira orçamento de substituição, não vira migração adiada para sempre.
O aviso pronto para mandar ao cliente, com data e responsável
O cliente não precisa entender o que é um vhost. Ele precisa entender que existe prazo e que alguém está cuidando. Um texto que funciona:
Três coisas tornam essa frase eficaz: tem data, tem responsável e já antecipa o único problema que costuma aparecer. Na minha experiência, avisar antes reduz atrito: a conversa passa a ser sobre custo de substituição de plugin, não sobre site fora do ar.
Checklist trimestral para refazer o inventário
- [ ] Rodar a extração de contas em cada servidor da revenda.
- [ ] Conferir se addons e subdomínios entraram na lista.
- [ ] Consultar você mesmo as datas de suporte na página de versões suportadas do projeto PHP e atualizar a coluna
suporte_atecom a data da consulta. - [ ] Revisar a recomendação de versão do servidor conforme a documentação do cPanel e validar numa conta real.
- [ ] Reordenar por
suporte_atee fechar as janelas das próximas quatro semanas. - [ ] Disparar o aviso aos clientes das janelas fechadas.
- [ ] Fechar os
travadosdo trimestre anterior com orçamento ou decisão registrada.
Quatro vezes por ano, e o tempo por servidor depende de quantas contas e quantos vhosts você tem. Em qualquer cenário é menos tempo do que uma única madrugada consertando um site que parou de receber correção dois anos atrás e ninguém notou.
Referências
- Documentação oficial (cpanel) — How to Set PHP Version Recommendations. Consultado em 2026-10-13.