Como ver a versão de PHP de cada site do servidor
Um inventário de leitura, em uma passada, que mostra versão, handler e limites efetivos por document root. Com a planilha pronta e a frase para avisar o cliente.

Resposta curta: em 3 comandos de leitura: o script `show-php-settings` do cPanel para versão, handler e limites efetivos, a leitura dos document roots em `/var/cpanel/userdata` e um grep por `php_value` nos .htaccess. O resultado vira uma planilha com uma linha por domínio.
Neste artigo
- Qual PHP esse site usa tem três respostas diferentes
- O comando do cPanel que lê versão, handler e limites de uma vez
- Por que MultiPHP Manager e phpinfo mostram versões diferentes
- Quando o php_value do .htaccess vale e quando é ignorado
- As doze colunas da planilha de inventário
- O que dizer ao cliente que roda PHP fora de suporte
- Cinco erros que estragam a coleta
Qual PHP esse site usa tem três respostas diferentes
Essa pergunta tem três respostas diferentes e elas podem não bater entre si.
- A versão atribuída ao vhost: o que o MultiPHP Manager mostra para aquele domínio.
- O handler que executa o PHP: PHP-FPM, LSAPI (mod_lsapi), suPHP ou CGI. É o handler que decide de onde vêm os limites.
- Os limites efetivos:
memory_limit,max_execution_time,upload_max_filesizeque o processo PHP realmente carregou, somandophp.inido pacote, pool do FPM,.user.inie, dependendo do handler,php_valueno.htaccess.
Para um inventário de revenda, só a primeira resposta é inútil. Você precisa das três lado a lado, porque o cliente que reclama de upload de 2 MB falhando pode estar em PHP 8.2 e ainda assim preso num upload_max_filesize herdado de um .htaccess escrito em 2019.
O comando do cPanel que lê versão, handler e limites de uma vez
O cPanel distribui um script de leitura para exatamente isso. Segundo a documentação do show-php-settings, ele exibe as configurações de PHP do servidor e das contas, incluindo versão, handler e diretivas. É leitura pura: não altera nada, então pode rodar em produção no meio da tarde.
# ver as opções suportadas na sua build antes de automatizar
/usr/local/cpanel/scripts/show-php-settings --help
# saída completa, salva para processar depois
/usr/local/cpanel/scripts/show-php-settings > /root/inventario-php-$(date +%F).txt
Rode o --help primeiro em vez de copiar flags de um blog. As opções variam entre versões do cPanel e o que interessa aqui é o inventário sair certo, não o one-liner ser bonito.
Uma linha por document root, não por conta cPanel
O inventário precisa de uma linha por document root, não por conta. Conta com dez addon domains tem dez vhosts e cada um pode estar numa versão diferente.
# usuários cPanel do servidor
ls -1 /var/cpanel/users
# document root de cada vhost de um usuário
grep -H documentroot /var/cpanel/userdata/USUARIO/*
Confira a saída do grep em duas ou três contas na mão antes de confiar nela em lote. Os arquivos de userdata incluem variantes com sufixo (.cache, SSL) e você não quer duplicar linhas na planilha por causa disso.
Como confirmar o valor que o PHP carregou no vhost
Quando a linha do inventário parecer estranha, confirme pelo lado do PHP, no contexto do vhost:
# limites efetivos da CLI do binário daquela versão (não é o do site, serve de referência)
/opt/cpanel/ea-php82/root/usr/bin/php -i | grep -E 'memory_limit|max_execution_time|upload_max_filesize'
CLI e web podem divergir, e divergem com frequência sob PHP-FPM, porque o pool do vhost aplica diretivas próprias. Para o valor real do site, um arquivo temporário com phpinfo() dentro do document root, removido logo depois, continua sendo o método mais direto. Deixe isso para os casos duvidosos, não para os 40 sites.
Por que MultiPHP Manager e phpinfo mostram versões diferentes
Quatro motivos cobrem quase tudo que você vai encontrar:
| Sintoma | Causa provável | Onde olhar |
|---|---|---|
| MultiPHP diz 8.1, phpinfo diz 7.4 | handler alternativo ou regra de AddHandler dentro do .htaccess |
.htaccess do document root |
memory_limit maior que o do pacote |
diretiva em pool FPM, .user.ini ou php_value sob LSAPI |
pool do vhost e .htaccess |
Mudança no .htaccess não surte efeito |
vhost sob PHP-FPM, que ignora php_value |
MultiPHP Manager, coluna handler |
Mudança no .user.ini demora a aparecer |
TTL de cache do .user.ini (user_ini.cache_ttl, padrão 300 segundos), que atrasa a leitura da alteração |
.user.ini no document root |
A coluna handler é o eixo da planilha inteira. Sem ela, você não sabe se o .htaccess é a fonte do limite ou enfeite.
Quando o php_value do .htaccess vale e quando é ignorado
Isso derruba muito inventário de agência, então vale ser explícito.
Sob PHP-FPM, o PHP roda fora do processo do Apache. Diretivas php_value e php_flag no .htaccess não são lidas pelo PHP e, em algumas configurações, chegam a gerar erro 500 no Apache quando o módulo que as interpreta não está carregado. Nesse cenário, a linha no .htaccess é ruído: o limite verdadeiro está no pool.
Sob mod_lsapi (CloudLinux) e sob suPHP, a história é outra: o php_value do .htaccess costuma ser aplicado. Apagar essas linhas em lote porque ".htaccess com PHP é dívida técnica" é o jeito mais rápido de derrubar o checkout de um cliente que dependia de um max_execution_time de 300.
Regra operacional para a equipe: na fase de inventário ninguém apaga nada. Você registra onde a diretiva está, qual handler está em vigor e se o valor efetivo bate com ela. A decisão de migrar o limite para o pool vem depois, site por site, com janela combinada.
As doze colunas da planilha de inventário
Uma linha por document root. Estas colunas resolvem o trabalho e sobrevivem à próxima rodada:
| Coluna | Conteúdo | De onde vem |
|---|---|---|
| usuario | conta cPanel | /var/cpanel/users |
| dominio | domínio ou subdomínio do vhost | userdata |
| docroot | caminho absoluto | userdata |
| versao_atribuida | ex.: ea-php82 | MultiPHP Manager / show-php-settings |
| handler | FPM, LSAPI, suPHP, CGI | show-php-settings |
| memory_limit | valor efetivo | phpinfo() no vhost ou pool do FPM |
| max_execution_time | valor efetivo | phpinfo() no vhost ou pool do FPM |
| upload_max_filesize | valor efetivo | phpinfo() no vhost ou pool do FPM |
| htaccess_php | sim/não, com as linhas encontradas | grep -l php_value nos docroots |
| fora_de_suporte | sim/não | calendário oficial do php.net |
| limite_divergente | sim/não | comparação com o padrão do pacote |
| acao | migrar versão, mover limite, nada | preenchida por você |
As duas colunas calculadas valem mais que as outras dez juntas. A saída do show-php-settings serve de ponto de partida para as três colunas de limite: ela dá o cenário do servidor e das contas, e o valor que vale para o vhost precisa de confirmação por phpinfo() ou pela leitura do pool naquele domínio. fora_de_suporte é a lista de trabalho do trimestre. limite_divergente é a lista de armadilhas: todo site com limite diferente do padrão do pacote vai quebrar de forma silenciosa se alguém trocar o handler sem levar o valor junto.
Para a coluna htaccess_php, uma varredura de leitura basta:
grep -rl --include='.htaccess' -E 'php_value|php_flag|AddHandler' /home/*/public_html /home/*/*/ 2>/dev/null
Ajuste os caminhos ao layout real dos document roots do servidor, que nem sempre estão sob public_html.
O que dizer ao cliente que roda PHP fora de suporte
O cliente não quer saber de handler. Ele quer saber se corre risco e quanto custa.
Frase pronta, para e-mail ou ticket:
Três coisas fazem essa frase funcionar: ela não ameaça, diz o que foi verificado, e já oferece a saída com plano de reversão. Guarde a versão adaptada ao seu texto padrão e reaproveite a cada rodada.
Para o inventário interno da agência, uma segunda frase ajuda no orçamento: site com limite_divergente marcado leva mais tempo de migração que site sem, porque além de trocar a versão você precisa levar o limite para o lugar certo do novo handler.
Cinco erros que estragam a coleta
- Rodar só no domínio principal. Addon domains e subdomínios têm vhost próprio e podem estar em outra versão. Se a planilha tem menos linhas que o servidor tem document roots, ela está errada.
- Confiar na CLI como valor do site.
php -ino terminal mostra o binário, não o pool do vhost. - Apagar
php_valueantes de conferir o handler. Sob LSAPI costuma estar valendo. - Deixar
phpinfo()para trás. Arquivo de diagnóstico esquecido no document root é informação de infraestrutura entregue de graça. Crie, leia, apague no mesmo minuto. - Não datar o arquivo. O inventário envelhece. Salve com a data no nome e repita a passada a cada ciclo de fim de suporte.
Feito uma vez com as colunas certas, a segunda rodada é um diff entre dois arquivos e uma reunião de quinze minutos.
Referências
- Documentação oficial (cpanel) — The show-php-settings Script. Consultado em 2026-10-13.