blog
Revenda

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.

JR · · 6 min de leitura · 2 tabelas · 4 blocos de código

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
  1. Qual PHP esse site usa tem três respostas diferentes
  2. O comando do cPanel que lê versão, handler e limites de uma vez
  3. Por que MultiPHP Manager e phpinfo mostram versões diferentes
  4. Quando o php_value do .htaccess vale e quando é ignorado
  5. As doze colunas da planilha de inventário
  6. O que dizer ao cliente que roda PHP fora de suporte
  7. 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.

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

Feito uma vez com as colunas certas, a segunda rodada é um diff entre dois arquivos e uma reunião de quinze minutos.

Referências

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