blog
Painéis

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.

JR · · 8 min de leitura · 1 tabela · 4 blocos de código

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
  1. O painel mostra um nível, a configuração tem quatro
  2. A ordem de precedência que decide versão e diretivas
  3. Uma `phpinfo()` por caminho mostra o que está valendo de verdade
  4. Achar o `.htaccess` que sobrescreve o painel
  5. Checklist de auditoria PHP que leva dez minutos por conta
  6. Quando o número bate no painel e o site continua estranho
  7. Como explicar o subdomínio desatualizado para o cliente
  8. 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:

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.

Precedência da versão do PHP no EasyApache 4handler no .htaccessVence tudo, por diretórioHost virtual no MultiPHPVersão própria do domínioPadrão da contaVale enquanto ninguém tocarPadrão do servidor (WHM)Último recurso da cascata
Quem decide a versão do PHP, do mais forte ao mais fraco.

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:

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.

Da divergência à causa em cinco etapasListar docrootsPrincipal, subdomínios, domínios adicionaisSubir phpinfo temporáriaUm arquivo por caminhoComparar painel e phpinfoDivergência vira investigaçãoGrep de handlerComente a linha, testeRemover testes e documentarVersão de cada host virtual
Sequência de auditoria por conta, sem adivinhação.

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.

  1. 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.
  2. 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.
  3. Suba a phpinfo() temporária em cada caminho da lista. Anote versão, Server API e Loaded Configuration File.
  4. Compare painel contra phpinfo(). Toda divergência vira item de investigação.
  5. Para cada divergência, rode o grep de handler e localize o arquivo responsável.
  6. 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.
  7. 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.
  8. 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:

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:

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

  1. Documentação oficial (cpanel) — PHP Inheritance (EasyApache 4). Consultado em 2026-11-01.
Leia também