# Mudei o PHP no painel e o subdomínio não mudou

Como ler a ordem de precedência do EasyApache 4, achar o arquivo que sobrescreve o painel e auditar a carteira inteira de clientes sem editar no escuro.

> o cPanel decide a versão do PHP em quatro níveis (servidor, conta, host virtual e diretório), e subdomínio ou domínio adicional tem host virtual próprio no MultiPHP Manager. Um `AddHandler` no `.htaccess` do diretório sobrescreve o painel.

João Rizzon · 2026-11-06 · Painéis

---

## O painel mostra um nível, a configuração tem quatro

Quando você abre o MultiPHP Manager e troca a versão de `cliente.com.br` para PHP 8.3, está editando **um** dos pontos onde o PHP é decidido. O EasyApache 4 trabalha com herança: existe um padrão de conta, existe uma configuração por host virtual, e existem arquivos dentro do próprio `public_html` que podem sobrescrever o que o painel diz. A [documentação de PHP Inheritance do cPanel](https://docs.cpanel.net/ea4/php/php-inheritance/) descreve exatamente esse encadeamento.

O caso clássico de agência: o site principal atualizou, o `blog.cliente.com.br` continuou em 7.4 e ninguém entende por quê. Na quase totalidade das vezes não é bug do servidor. É que subdomínio e domínio adicional têm **host virtual próprio** no cPanel, com entrada própria no MultiPHP Manager, e você mudou só a linha do domínio principal. Ou existe um `.htaccess` antigo dentro daquela pasta com um `AddHandler` fixando a versão.

O erro caro é editar antes de descobrir. Você troca o handler no `.htaccess`, o site cai com erro 500, e agora há duas variáveis soltas em vez de uma.

## A ordem de precedência que decide versão e diretivas

Vale separar duas coisas que costumam ser confundidas: **qual versão do PHP** roda, e **quais diretivas** (memory_limit, upload_max_filesize, max_execution_time) valem. São decididas por mecanismos diferentes.

| O que está sendo decidido | Quem decide, do mais forte ao mais fraco |
|---|---||
| Versão do PHP | handler declarado no `.htaccess` do diretório > configuração do host virtual (MultiPHP Manager, por domínio) > versão padrão da conta > versão padrão do servidor (WHM) |
| Diretivas de runtime | `ini_set()` no código > `.user.ini` do diretório > `php.ini`/INI Editor do host virtual > `php.ini` padrão da versão |

Dois pontos práticos que derrubam muita gente:

- O `.htaccess` só muda a **versão** se contiver uma diretiva de handler. Um `.htaccess` do WordPress com regras de rewrite não interfere em nada disso.
- Com PHP-FPM, `php_value` e `php_flag` dentro do `.htaccess` normalmente derrubam o site com erro 500: o Apache não reconhece a diretiva, que pertence ao mundo do mod_php. O caminho correto nesse cenário é `.user.ini` ou o MultiPHP INI Editor. Se você está há vinte minutos tentando aumentar `memory_limit` por `.htaccess` e o site respondeu 500, provavelmente é isso.

A herança da conta funciona como cascata: um host virtual que nunca foi tocado individualmente segue o padrão da conta; no momento em que alguém define a versão daquele domínio específico, ele deixa de herdar e passa a ter valor próprio, mesmo que você mude o padrão depois.

## Uma `phpinfo()` por caminho mostra o que está valendo de verdade

O painel diz o que **deveria** valer. A página `phpinfo()` diz o que **está** valendo naquele caminho exato. Para auditar um site com subdomínios e subpastas, coloque um arquivo em cada caminho suspeito.

```bash
# exemplo fictício de estrutura de uma conta
/home/cliente/public_html/            -> cliente.com.br
/home/cliente/public_html/loja/       -> subpasta com .htaccess próprio
/home/cliente/blog/                   -> blog.cliente.com.br (vhost próprio)

# crie um arquivo temporário com nome não óbvio em cada docroot
for d in /home/cliente/public_html /home/cliente/public_html/loja /home/cliente/blog; do
  printf '<?php phpinfo();' > "$d/zz-check-9f21.php"
done
```

Abra `https://cliente.com.br/zz-check-9f21.php`, depois `.../loja/zz-check-9f21.php`, depois `https://blog.cliente.com.br/zz-check-9f21.php`. Em cada uma, anote quatro campos:

- **PHP Version** no topo: a versão que realmente executou aquele arquivo.
- **Server API**: diz se é FPM, CGI/FastCGI ou módulo. Define se `.user.ini` vale e se `php_value` no `.htaccess` vale.
- **Loaded Configuration File**: qual `php.ini` foi carregado. O caminho costuma conter o nome da versão, o que confirma o handler.
- **Additional .ini files parsed** e, logo abaixo, o campo que aponta o `user_ini.filename`: mostra se há um `.user.ini` entrando no meio.

Se os três caminhos mostram versões diferentes, você acabou de mapear a herança sem adivinhar nada.

### Remova a página de teste assim que terminar a leitura

`phpinfo()` expõe caminhos absolutos, extensões carregadas e configuração do servidor. Não é catástrofe, mas é informação de reconhecimento de graça para quem varre a internet. Use nome aleatório, confira, e remova:

```bash
find /home/cliente -name 'zz-check-9f21.php' -delete
```

## Achar o `.htaccess` que sobrescreve o painel

Se a `phpinfo()` do subdomínio mostra uma versão diferente da que o MultiPHP Manager exibe, há um handler declarado em algum `.htaccess` daquele ramo. Por SSH, procure assim:

```bash
grep -rn -i -e 'AddHandler' -e 'AddType' -e 'SetHandler' \
  --include='.htaccess' /home/cliente/
```

E para as diretivas de runtime:

```bash
find /home/cliente -name '.user.ini' -o -name 'php.ini' | head -50
```

Sem SSH, dá para fazer o mesmo pelo Gerenciador de Arquivos do cPanel: ative a exibição de arquivos ocultos e abra o `.htaccess` de cada docroot. É mais lento, mas funciona.

Quando encontrar a linha, **não apague de imediato**. Comente com `#`, salve, e recarregue a `phpinfo()` daquele caminho. Se a versão mudou para a esperada, você confirmou a causa. Se o site deu 500, descomente e você perdeu trinta segundos em vez de uma tarde. Esse vai e volta é o que separa diagnóstico de chute.

### Por que o `.htaccess` tem aquela linha de handler

Quase sempre três origens: migração de outro servidor que trouxe o arquivo junto, plugin ou painel antigo que escreveu a diretiva, ou um colega que resolveu um problema em 2019 e nunca removeu. A diretiva de handler sobrevive a qualquer mudança no painel, porque é lida a cada requisição no diretório.

## Checklist de auditoria PHP que leva dez minutos por conta

Rode isto uma vez por site e guarde o resultado numa planilha. Da segunda vez em diante leva poucos minutos por conta.

- No cPanel, abra **MultiPHP Manager** e fotografe a lista inteira. Conte as linhas: cada subdomínio e cada domínio adicional aparece separado. Registre quais estão marcados como herdando o padrão da conta e quais têm versão própria.
- Liste os docroots reais da conta (domínio principal, cada subdomínio, cada domínio adicional) e as subpastas que rodam aplicação própria, não só assets.
- Suba a `phpinfo()` temporária em cada caminho da lista. Anote versão, Server API e Loaded Configuration File.
- Compare painel contra `phpinfo()`. Toda divergência vira item de investigação.
- Para cada divergência, rode o `grep` de handler e localize o arquivo responsável.
- Confira o **MultiPHP INI Editor** por domínio: diretivas definidas ali valem para aquele host virtual e explicam limites diferentes entre site principal e subdomínio.
- Verifique se há `.user.ini` dentro de pastas de aplicação. Lembre que ele tem cache com TTL padrão de 300 segundos (`user_ini.cache_ttl`): a mudança pode levar até 5 minutos para aparecer, então não conclua cedo demais que não pegou.
- Remova as páginas de teste e registre no documento do cliente qual versão cada host virtual está rodando e por quê.

Padronizar vale mais que acertar caso a caso. A regra que mais reduz retrabalho: **a versão do PHP mora no MultiPHP Manager, nunca no `.htaccess`**. Se um site da carteira tem handler no `.htaccess`, o item de backlog é remover o handler e definir a versão no painel, não ajustar o handler.

## Quando o número bate no painel e o site continua estranho

Nem toda diferença de comportamento é diferença de versão. Antes de abrir chamado, elimine quatro suspeitos:

- **Cache de opcode e de página.** Opcache mantém bytecode compilado; cache de página (LSCache, plugin, CDN) devolve HTML antigo. Teste sempre numa URL com parâmetro novo ou em aba anônima, e limpe o cache do site antes de concluir qualquer coisa.
- **CLI diferente do web.** `php -v` no SSH mostra a versão de linha de comando, que pode ser outra. Para rodar o WP-CLI na versão certa, chame o binário daquela versão explicitamente, por exemplo `/opt/cpanel/ea-php83/root/usr/bin/php $(which wp) plugin list`. Confirme qual versão você quer pelo campo **PHP Version** da `phpinfo()` do docroot em questão.
- **Extensões faltando.** Trocar de versão não traz as extensões junto. Se `imagick` ou `intl` estavam habilitadas na 7.4 e ninguém marcou na 8.3, o site quebra parecendo problema de versão.
- **Redirecionamento silencioso.** O subdomínio pode estar apontando para o docroot do domínio principal. Nesse caso os dois sempre mostram a mesma versão, porque são o mesmo diretório. O campo `DOCUMENT_ROOT` na `phpinfo()` entrega isso na hora.

## Como explicar o subdomínio desatualizado para o cliente

O cliente não quer ouvir sobre host virtual. Quer entender por que pagou por uma atualização que, para ele, não aconteceu. Use alguma versão disto:

> **** No cPanel, cada subdomínio é tratado como um site independente, com configuração de PHP própria. A atualização que fizemos valeu para o domínio principal; o subdomínio continuava com a configuração antiga porque ele tem a dele. Já identificamos onde estava fixada, corrigimos, e documentamos a versão de cada endereço do seu plano para que a próxima atualização pegue tudo de uma vez.

Se a causa foi um `.htaccess` herdado de migração, acrescente uma frase: a configuração veio junto do servidor anterior e tinha prioridade sobre o painel, o que explica por que o ajuste anterior não surtiu efeito.

## Depois da auditoria, trave o processo

Três hábitos que evitam a reincidência na carteira inteira:

- **Atualização de PHP é por conta, não por domínio.** Sempre que subir a versão de um site, abra o MultiPHP Manager e confira a lista inteira na mesma janela. O subdomínio esquecido custa mais caro depois, quando ele quebra sozinho numa sexta-feira.
- **Nada de versão no `.htaccess`.** Se encontrar, remova e resolva no painel. É a única forma de o painel continuar sendo fonte de verdade.
- **Documento de uma página por cliente** com a lista de hosts virtuais, versão atual, extensões necessárias e data da última revisão. Esse documento é o que transforma a auditoria de uma hora na primeira vez em dez minutos nas próximas.

Este artigo descreve o comportamento de herança conforme a [documentação oficial do cPanel para EasyApache 4](https://docs.cpanel.net/ea4/php/php-inheritance/); os caminhos e nomes de domínio usados nos comandos são exemplos fictícios e devem ser trocados pelos da conta auditada. Não há medição própria aqui: a verificação confiável é a que você roda no servidor do cliente, com a `phpinfo()` no caminho exato.

