blog
Revenda

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.

JR · · 7 min de leitura · 1 tabela · 1 bloco de código

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
  1. As quatro perguntas que o inventário precisa responder
  2. Como tirar a lista de domínios e versões do WHM
  3. Seis colunas que bastam, e a única que não sai do cPanel
  4. Fazer o painel do cliente avisar que a versão está velha
  5. Ordenar por data de fim de suporte e fechar as janelas
  6. O aviso pronto para mandar ao cliente, com data e responsável
  7. 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:

  1. Quais domínios rodam qual versão de PHP hoje.
  2. Quais dessas versões ainda recebem correção de segurança do projeto PHP.
  3. Quem é o cliente responsável por cada domínio e quem paga a migração.
  4. 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.

Ordem de montagem do inventário de PHPExtrairContas e vhosts por servidorClassificarVersão e fim de suporteAtribuirCliente responsável e contatoAgendarSemana da janela de migração
As quatro etapas que o inventário precisa cobrir, na ordem em que a planilha é montada.

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:

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:

Fluxo de uma janela semanal de migraçãoOrdenar por fim de suporteMais antigo migra primeiroAgrupar por clienteSites do mesmo dono juntosBackup e nota da versão atualSaber para onde voltarTrocar versão no MultiPHPFora de sexta em e-commerceTestar e ler log de erroFormulário, checkout, loginMarcar migrado ou travadoTravado vira orçamento
Fluxo de uma janela de migração, do ordenamento da planilha ao status final.

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

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

  1. Documentação oficial (cpanel) — How to Set PHP Version Recommendations. Consultado em 2026-10-13.
Leia também