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.

Resposta curta: 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.
Neste artigo
- O painel mostra um nível, a configuração tem quatro
- A ordem de precedência que decide versão e diretivas
- Uma `phpinfo()` por caminho mostra o que está valendo de verdade
- Achar o `.htaccess` que sobrescreve o painel
- Checklist de auditoria PHP que leva dez minutos por conta
- Quando o número bate no painel e o site continua estranho
- Como explicar o subdomínio desatualizado para o cliente
- Depois da auditoria, trave o processo
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 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
.htaccesssó muda a versão se contiver uma diretiva de handler. Um.htaccessdo WordPress com regras de rewrite não interfere em nada disso. - Com PHP-FPM,
php_valueephp_flagdentro do.htaccessnormalmente 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.iniou o MultiPHP INI Editor. Se você está há vinte minutos tentando aumentarmemory_limitpor.htaccesse 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.
# 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.inivale e sephp_valueno.htaccessvale. - Loaded Configuration File: qual
php.inifoi 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.inientrando 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:
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:
grep -rn -i -e 'AddHandler' -e 'AddType' -e 'SetHandler' \
--include='.htaccess' /home/cliente/
E para as diretivas de runtime:
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
grepde 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.inidentro 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 -vno 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 daphpinfo()do docroot em questão. - Extensões faltando. Trocar de versão não traz as extensões junto. Se
imagickouintlestavam 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_ROOTnaphpinfo()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:
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; 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.
Referências
- Documentação oficial (cpanel) — PHP Inheritance (EasyApache 4). Consultado em 2026-11-01.