blog
Revenda

Ver a versão de PHP de todos os sites do WHM de uma vez

Como montar, em uma sessão de SSH, uma tabela com domínio, usuário, versão, handler e limites de PHP de todos os sites do servidor, e o que fazer com ela depois.

JR · · 7 min de leitura · 2 tabelas · 8 blocos de código

Resposta curta: rode `whmapi1 php_get_vhost_versions` no WHM via SSH para listar domínio, conta e versão de PHP de todos os vhosts de uma vez, compare com `php_get_system_default_version` para saber quem só herdou o padrão e confirme os limites em vigor com phpinfo no próprio domínio.

Neste artigo
  1. As seis informações que todo inventário de PHP precisa ter
  2. Os dois comandos whmapi1 que listam a versão de cada vhost
  3. Os quatro caminhos por onde um memory_limit chega ao site
  4. Sob mod_lsapi, php_value no .htaccess pode continuar valendo
  5. Em que ordem atacar os sites depois do levantamento
  6. Como avisar o cliente que o PHP dele saiu de suporte
  7. Resumo operacional

Quem cuida de 40, 80, 200 sites em um servidor com WHM não precisa saber em qual versão de PHP está um domínio. Precisa saber em qual versão estão todos, de uma vez, com o handler e os limites ao lado. É esse levantamento que falta: a troca de versão por domínio está documentada em todo lugar, o inventário em lote não.

Aviso antes de qualquer comando: não há medição própria neste artigo. Nada aqui foi cronometrado ou comparado em laboratório. É procedimento apoiado na documentação do cPanel e em leitura de arquivos do próprio servidor. Onde eu colocar um valor de exemplo, ele está marcado como exemplo.

As seis informações que todo inventário de PHP precisa ter

Um inventário útil tem seis blocos de informação, que viram oito colunas na planilha, porque a última linha se desdobra em três. Menos que isso e você volta no servidor na semana seguinte.

Coluna De onde vem Por que importa
Domínio lista de vhosts do WHM é a chave da planilha
Usuário cPanel mesma origem agrupa domínios da mesma conta
Versão PHP php_get_vhost_versions define o que está sem suporte
É a versão padrão do sistema? comparação com php_get_system_default_version separa herdado de escolhido
Handler configuração do MultiPHP / show-php-settings muda o efeito de .htaccess
memory_limit, max_execution_time, upload_max_filesize (três colunas) php.ini do pacote + .user.ini/php.ini do vhost + php_value em .htaccess explica lentidão e erro de upload

A informação que quase todo mundo esquece é a quarta linha da tabela. Um site em PHP 8.1 porque alguém escolheu 8.1 é diferente de um site em 8.1 porque é o padrão do sistema. No primeiro caso, mexer quebra o combinado com o cliente. No segundo, ele vai junto na próxima mudança de padrão, sem aviso.

Os dois comandos whmapi1 que listam a versão de cada vhost

Todos rodam como root, por SSH.

# versão de PHP de cada vhost do servidor
whmapi1 php_get_vhost_versions --output=jsonpretty

# versão padrão do sistema (a herdada por quem está em "inherit")
whmapi1 php_get_system_default_version

O primeiro lista os vhosts do servidor com a versão de PHP de cada um. Não tome os nomes das chaves como garantidos: abra o JSON cru no seu servidor e confira o que veio, porque isso varia entre versões do WHM. O segundo devolve uma string só, que é o que você compara. Para guardar a saída, redirecione o jsonpretty para um arquivo (> /root/vhosts-php.json) e abra depois com calma; para processar com jq, use --output=json, que é compacto.

Para extrair só domínio e versão em formato de planilha:

whmapi1 --output=json php_get_vhost_versions \
  | jq -r '.data.versions[] | [.vhost, .account, .version, .php_fpm] | @csv' \
  > /root/inventario-php.csv

Confira o CSV antes de confiar nele: head -5 /root/inventario-php.csv. Se algum campo vier vazio, é porque aquela chave não existe na sua versão do WHM, e aí vale abrir o JSON cru e olhar os nomes reais das chaves antes de insistir no jq.

show-php-settings, a leitura oficial das configurações do servidor

O cPanel distribui um script próprio para despejar as configurações de PHP do servidor, o show-php-settings, documentado em The show-php-settings Script. Ele é o caminho oficial para ver o que está valendo por instalação de PHP, em vez de adivinhar lendo arquivo por arquivo:

/usr/local/cpanel/scripts/show-php-settings

Use a saída dele como a linha-base do servidor: qual pacote de PHP existe, qual handler está associado e quais valores vieram de fábrica. Tudo que destoar disso, no nível do domínio, é alteração manual, e é exatamente isso que você quer marcar na planilha.

Os quatro caminhos por onde um memory_limit chega ao site

Um valor de memory_limit pode chegar ao site por quatro caminhos diferentes. Na prática, você procura nesta ordem:

  1. php.ini do pacote, em /opt/cpanel/ea-phpXX/root/etc/php.ini. É a fábrica.
  2. php.ini por vhost, quando o MultiPHP INI Editor gravou um arquivo específico para o domínio.
  3. .user.ini na pasta do site, lido por PHP-FPM e por alguns handlers.
  4. php_value / php_flag em .htaccess, que historicamente era coisa de mod_php, mas pode continuar sendo interpretado sob mod_lsapi.

Para varrer o quarto caso em todas as contas de uma vez, lembre que addon domain e subdomínio quase nunca ficam em public_html: varrer só essa pasta perde parte dos sites. Monte a lista de docroots a partir do userdata do cPanel e passe ela para o grep:

DOCROOTS=$(grep -h '^ *documentroot:' /var/cpanel/userdata/*/* 2>/dev/null \
  | awk '{print $2}' | sort -u)

grep -rIl --include=.htaccess -e 'php_value' -e 'php_flag' $DOCROOTS 2>/dev/null

E para ver as linhas, não só os arquivos:

grep -rI --include=.htaccess -e 'php_value' -e 'php_flag' $DOCROOTS 2>/dev/null

Em servidor com muitas contas isso faz I/O. Rode fora do pico e redirecione para arquivo. Se $DOCROOTS vier vazio, confira o caminho dos arquivos de userdata antes de cair de volta no /home/*/public_html/.

Por onde um memory_limit chega ao sitephp.ini do pacoteValor de fábrica da instalaçãophp.ini por vhostGravado pelo MultiPHP INI Editor.user.ini na pasta do siteLido por PHP-FPM e similaresphp_value em .htaccessPode valer sob mod_lsapiConfirmar com phpinfo no domínioCompare Local e Master Value
Ordem de busca quando um limite não bate com o esperado. O último passo é o único que confirma o valor em uso.

Sob mod_lsapi, php_value no .htaccess pode continuar valendo

Aqui está o erro caro. Chega um dev novo, vê php_value memory_limit 256M em um .htaccess, acha que é resíduo de mod_php de 2016 e apaga. O site passa a estourar memória em importação de produto e ninguém liga uma coisa à outra por três dias.

Sob mod_lsapi, dependendo de como o handler está configurado, diretivas php_value em .htaccess podem continuar valendo. Não assuma nem que valem nem que não valem. Confirme no próprio domínio:

# criado como root: ajuste dono e permissão, senão suexec/lsapi pode devolver 403
printf '<?php phpinfo();' > /home/USUARIO/public_html/_chk.php
chown USUARIO:USUARIO /home/USUARIO/public_html/_chk.php
chmod 644 /home/USUARIO/public_html/_chk.php

Abra https://dominio/_chk.php, procure memory_limit e compare as colunas Local Value e Master Value. Local diferente de Master significa que alguma coisa, no nível do site, está sobrescrevendo. Depois:

rm -f /home/USUARIO/public_html/_chk.php

Apague o arquivo no mesmo expediente. phpinfo() exposto é inventário pronto para quem for procurar vulnerabilidade no servidor.

Se quiser evitar o arquivo público, a leitura por linha de comando ajuda a entender o pacote, mas não reproduz o contexto do Apache:

/opt/cpanel/ea-php81/root/usr/bin/php -i | grep -E '^(memory_limit|max_execution_time|upload_max_filesize)'

Isso mostra o CLI daquela instalação, não o que o vhost está usando. Serve para a linha-base, não para a conclusão. Para a conclusão, phpinfo no domínio.

Em que ordem atacar os sites depois do levantamento

Com o CSV na mão, a ordem de ataque é por risco, não por cliente que reclama mais.

Prioridade Critério Ação
1 Versão de PHP sem suporte de segurança agendar atualização, testar em staging
2 Versão sem suporte e php_value em .htaccess mapear diretivas antes de tocar na versão
3 Versão herdada do padrão do sistema avisar o cliente que ela muda quando o padrão mudar
4 Limites alterados à mão sem motivo registrado documentar o porquê, não apagar
5 Resto revisar no próximo ciclo trimestral

Coluna extra que vale ouro na agência: "motivo do valor custom". Toda vez que você subir memory_limit ou max_execution_time em um site, escreva ali por quê (importador do WooCommerce, gerador de PDF, migração do Elementor). Daqui a dois anos, quem herdar o servidor vai saber se pode remover.

Inventário trimestral e diff para ver o que mudou sem você saber

Inventário de PHP em lote, do comando ao diffListar vhostswhmapi1 php_get_vhost_versionsComparar com padrãoSepara herdado de escolhidoVarrer .htaccessgrep por php_value em todos docrootsPriorizar por riscoSem suporte primeiro, não quem reclamaVersionar o CSVDiff trimestral mostra o que mudou
Ciclo de inventário reutilizável em qualquer servidor WHM da carteira.

Como avisar o cliente que o PHP dele saiu de suporte

A pior forma de comunicar isso é técnica. "Seu site está em PHP 7.4 e o handler é lsapi" não gera decisão nenhuma do outro lado.

Frase pronta, para e-mail ou WhatsApp:

Três coisas estão ali de propósito: reconhece que o site funciona (senão o cliente acha que você está inventando problema), nomeia o risco em uma frase, e já propõe data. Proposta com data fechada tem resposta. Diagnóstico sem data vira pendência eterna.

Resumo operacional

Remover diretiva porque "ficou feio" no .htaccess é como apagar comentário em código que você não escreveu. Mapeie, confirme, documente o motivo, e só então limpe.

Referências

  1. Documentação oficial (cpanel) — The show-php-settings Script. Consultado em 2026-10-13.
Leia também