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

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

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

---

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.

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

```bash
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](https://docs.cpanel.net/whm/scripts/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:

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

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

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

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

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

```bash
/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 `diff` do 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-settings` junto, 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:

> **** Fizemos o levantamento de todos os sites hospedados e o seu está rodando em uma versão do PHP que não recebe mais correções de segurança. Não há falha visível hoje, o site funciona normalmente, mas a partir de agora qualquer vulnerabilidade descoberta nessa versão não será corrigida. Vamos atualizar em ambiente de teste primeiro, validar as páginas principais e o checkout, e só depois aplicar no site real. A janela sugerida é [data], fora do horário comercial. Se algum plugin não for compatível, avisamos antes de prosseguir.

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_versions` dá a lista por domínio, `php_get_system_default_version` dá 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](https://docs.cpanel.net/whm/scripts/the-show-php-settings-script/).
- `grep` por `php_value` e `php_flag` nos `.htaccess` acha 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.

