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.

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
- As seis informações que todo inventário de PHP precisa ter
- Os dois comandos whmapi1 que listam a versão de cada vhost
- Os quatro caminhos por onde um memory_limit chega ao site
- Sob mod_lsapi, php_value no .htaccess pode continuar valendo
- Em que ordem atacar os sites depois do levantamento
- Como avisar o cliente que o PHP dele saiu de suporte
- 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:
- php.ini do pacote, em
/opt/cpanel/ea-phpXX/root/etc/php.ini. É a fábrica. - php.ini por vhost, quando o MultiPHP INI Editor gravou um arquivo específico para o domínio.
- .user.ini na pasta do site, lido por PHP-FPM e por alguns handlers.
- php_value / php_flag em .htaccess, que historicamente era coisa de
mod_php, mas pode continuar sendo interpretado sobmod_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/.
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
- Rode o inventário em data fixa, trimestral, e versione os CSVs com a data no nome:
inventario-php-2026-01.csv. - Compare com o
diffdo trimestre anterior. O que mudou sem você saber é o que merece investigação. - Fixe a versão de PHP explicitamente nos sites críticos, em vez de deixar em "herdar". Herdar é cômodo até o dia em que o padrão do sistema muda.
- Guarde a saída do
show-php-settingsjunto, no mesmo diretório. Ela é a referência de fábrica daquele mês.
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
whmapi1 php_get_vhost_versionsdá a lista por domínio,php_get_system_default_versiondá a referência para saber quem está herdando./usr/local/cpanel/scripts/show-php-settingsé a leitura oficial das configurações do servidor, conforme a documentação do cPanel.grepporphp_valueephp_flagnos.htaccessacha o que foi mexido à mão, desde que você varra todos os docroots, não sópublic_html.phpinfo()no domínio, comparando Local Value e Master Value, é o único jeito de confirmar o que está valendo de verdade. Apague o arquivo depois.- Nenhum desses passos envolve medição de desempenho feita por mim. É inventário, não benchmark.
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
- Documentação oficial (cpanel) — The show-php-settings Script. Consultado em 2026-10-13.