# 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.

> 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.

João Rizzon · 2026-11-04 · Revenda

---

## 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_filesize` que o processo PHP realmente carregou, somando `php.ini` do pacote, pool do FPM, `.user.ini` e, dependendo do handler, `php_value` no `.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](https://docs.cpanel.net/whm/scripts/the-show-php-settings-script/), 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.

```bash
# 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.

```bash
# 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:

```bash
# 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:

```bash
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:

> **** O site de vocês roda hoje em PHP 7.4, versão que não recebe mais correções de segurança da equipe oficial do PHP. Isso não derruba o site amanhã, mas significa que qualquer falha descoberta de agora em diante não será corrigida nessa versão. Levantamos o cenário do site e a atualização para uma versão suportada é viável. Proponho uma janela de 1 hora, com cópia do site antes, teste de checkout e formulários depois, e retorno imediato à versão atual se algo não passar no teste.

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 -i` no terminal mostra o binário, não o pool do vhost.
- **Apagar `php_value` antes 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.

