PHP diferente em subpasta e subdomínio no cPanel
Uma regra única de herança para servidor, domínio, subdomínio e subpasta no cPanel, com uma página de teste que mostra qual versão e quais diretivas valem em cada caminho.

Resposta curta: no cPanel com EasyApache 4, a versão do PHP vale por diretório: cada pasta herda da pasta acima até achar um handler no .htaccess. Se a subpasta ou subdomínio tem definição própria, ela vence a do domínio principal.
Neste artigo
- A regra que explica quase todos os casos
- Em que ordem servidor, domínio, subdomínio e subpasta se aplicam
- Como saber qual PHP vale em cada caminho
- Encontrando o arquivo que está sobrescrevendo
- Como manter a mesma versão de PHP em vários sites
- O que dizer ao cliente quando uma pasta ficou com outra versão
- Quando o problema não é herança
A regra que explica quase todos os casos
No cPanel com EasyApache 4, a versão do PHP não é uma configuração da conta inteira. Ela é aplicada por diretório, e cada diretório herda do diretório acima dele até encontrar uma definição. A documentação oficial de herança de PHP do cPanel descreve esse comportamento: quando você escolhe uma versão para um domínio no MultiPHP Manager, o sistema grava um handler no .htaccess da raiz de documentos desse domínio. Subdiretórios sem definição própria herdam esse handler. Um domínio ou subdomínio marcado como inherit não grava handler próprio: herda do diretório pai e só chega ao padrão do servidor quando nenhum diretório acima dele tem handler.
Traduzindo para o dia a dia: quando você muda o PHP no painel e uma subpasta ou subdomínio continua diferente, quase sempre existe um .htaccess mais próximo daquele caminho com outro handler. Ou então o subdomínio tem configuração própria no MultiPHP Manager. O painel não está errado. Ele aplicou a mudança exatamente onde você pediu, e outro arquivo manda no caminho que você está testando.
Este guia junta os quatro níveis (servidor, domínio, subdomínio e subpasta) numa regra só e dá uma página de teste para provar qual configuração vale em cada caminho.
Em que ordem servidor, domínio, subdomínio e subpasta se aplicam
Pense de cima para baixo, mas resolva de baixo para cima. O PHP que roda num arquivo é o definido no diretório mais próximo dele que tenha definição. Se não houver nenhuma, vale o nível acima.
| Nível | Onde a definição fica | O que acontece sem definição própria |
|---|---|---|
| Servidor | Versão padrão do sistema, definida pelo administrador no WHM | É o ponto final da herança |
| Domínio principal | Handler no .htaccess da raiz do domínio (geralmente public_html) |
Com a opção inherit, segue o padrão do servidor |
| Subdomínio ou domínio adicional | Handler no .htaccess da raiz de documentos dele |
Herda do diretório pai se a raiz estiver dentro de outro domínio |
| Subpasta comum | .htaccess dentro da própria pasta |
Herda do diretório pai mais próximo com handler |
O ponto que confunde é a terceira linha. Um subdomínio cuja raiz é public_html/loja está fisicamente dentro do domínio principal. Se ele não tiver versão própria, herda a do principal. Se tiver, a dele vence, e mudar o principal não muda nada nele. Já um subdomínio com raiz fora de public_html (por exemplo, ~/loja.exemplo.com.br) não herda do domínio principal pelo caminho de diretórios: depende da configuração dele no MultiPHP Manager ou do padrão do servidor.
A partir daqui, o que dizemos sobre diretivas é orientação prática de operação: a página de herança citada acima trata só da versão. As diretivas de php.ini (memory_limit, upload_max_filesize, max_execution_time) seguem lógica parecida, mas o arquivo que manda depende de como o PHP roda. A linha SAPI da página de teste abaixo mostra isso:
fpm-fcgi(PHP-FPM): vale a configuração do pool do domínio mais o.user.ininas pastas. Umphp.inisolto na raiz de documentos ou numa subpasta não é lido nesse modo. O.user.inié relido em intervalos definidos poruser_ini.cache_ttl(300 segundos por padrão), então a mudança pode levar alguns minutos para aparecer.php_valueno.htaccessnão funciona nesse modo e costuma gerar erro 500.cgi-fcgi: o PHP pode ler umphp.inido domínio ou do diretório, além do.user.ini.php_valueno.htaccesstambém não funciona aqui.apache2handler(DSO): valemphp_valueephp_flagno.htaccess. O.user.inié ignorado.litespeed(LSAPI): em geral aceitaphp_valueephp_flagno.htaccessalém dephp.ini. Confirme com a página de teste depois de cada mudança.
Em qualquer SAPI, não presuma qual arquivo manda: confira as linhas SAPI, php.ini carregado e Arquivos .ini adicionais da página de teste, que mostram o modo de execução e o que foi de fato lido naquele caminho.
Como saber qual PHP vale em cada caminho
Em vez de abrir phpinfo() inteiro e caçar linha, use um arquivo curto que responde só o que importa. Salve como qualphp.php e copie para cada caminho que você quer comparar: raiz do domínio, a subpasta problemática e a raiz do subdomínio.
<?php
header('Content-Type: text/plain; charset=utf-8');
echo 'Caminho: ' . __DIR__ . "\n";
echo 'Versao PHP: ' . PHP_VERSION . "\n";
echo 'SAPI: ' . php_sapi_name() . "\n";
echo 'php.ini carregado: ' . php_ini_loaded_file() . "\n";
echo 'Arquivos .ini adicionais: ' . php_ini_scanned_files() . "\n";
echo 'memory_limit: ' . ini_get('memory_limit') . "\n";
echo 'upload_max_filesize: ' . ini_get('upload_max_filesize') . "\n";
echo 'max_execution_time: ' . ini_get('max_execution_time') . "\n";
Abra no navegador exemplo.com.br/qualphp.php, exemplo.com.br/subpasta/qualphp.php e sub.exemplo.com.br/qualphp.php. Os domínios aqui são exemplos; troque pelos do cliente. Se a versão ou o memory_limit mudar entre um endereço e outro, você já sabe em que nível está a diferença.
Dois cuidados. Apague o arquivo assim que terminar, porque ele expõe caminhos do servidor. E teste com cache desligado ou com parâmetro na URL (?t=1), já que plugin de cache ou CDN pode servir uma resposta antiga e te fazer achar que a mudança não pegou.
Encontrando o arquivo que está sobrescrevendo
Com a página de teste apontando o caminho divergente, o próximo passo é achar a definição local. Via terminal (SSH ou Terminal do cPanel), estes três comandos cobrem a maioria dos cenários:
# Handlers de PHP gravados em .htaccess (EasyApache e formatos antigos)
grep -rniE --include=.htaccess 'AddHandler|SetHandler|AddType' ~/public_html
# Diretivas de PHP gravadas em .htaccess
grep -rniE --include=.htaccess 'php_value|php_flag' ~/public_html
# Arquivos de configuração do PHP espalhados em subpastas
find ~/public_html \( -name php.ini -o -name .user.ini \)
Se as raízes dos subdomínios ficam fora de public_html, rode os mesmos comandos apontando para elas.
O resultado do primeiro grep mostra linhas como AddHandler application/x-httpd-ea-php81 .php .php8 .phtml. O número no nome do handler indica a versão. Handlers trazidos de outro servidor aparecem em outros formatos, como x-httpd-php70, alt-php ou um SetHandler: também tentam definir versão e devem ser revisados, mesmo sem conter ea-php. Se a subpasta tem um handler com versão diferente da raiz, é ele que manda ali. Os motivos mais comuns para esse handler existir:
- Migração de outro servidor que trouxe
.htaccessantigos junto com os arquivos. - Instalação de sistema em subpasta (loja, blog, ambiente de homologação) feita em outra época, com versão escolhida separadamente.
- Plugin de segurança ou cache que regravou o
.htaccesse preservou um bloco antigo. - Subdomínio configurado individualmente no MultiPHP Manager.
Como corrigir sem quebrar outra coisa
- Decida qual versão cada caminho deve usar. Às vezes a subpasta ficou na versão antiga de propósito, porque o sistema dela não roda na nova.
- Para subdomínios e domínios adicionais, ajuste pelo MultiPHP Manager, não editando o
.htaccessna mão. O painel grava o handler correto para o servidor. - Para subpastas comuns que devem seguir o domínio, remova o bloco de handler do
.htaccessda subpasta (faça cópia antes). Sem definição local, ela volta a herdar. - Para diretivas de
php.ini, nossa orientação prática é preferir o MultiPHP INI Editor por domínio, conferir o SAPI na página de teste e eliminarphp.ini,.user.iniou linhasphp_valueesquecidos em subpastas, a menos que existam por motivo conhecido. - Rode a página de teste de novo em todos os caminhos e só então apague o arquivo.
Como manter a mesma versão de PHP em vários sites
Se você mantém dezenas de sites, o problema não é corrigir um caso: é não deixar ele voltar. Este roteiro serve para qualquer troca de versão de PHP:
- Antes da troca, rode os dois
grepe ofindacima e salve a saída. Você fica com um inventário de onde existem definições locais. - Liste subdomínios e domínios adicionais da conta e anote se cada um está em inherit ou com versão fixa no MultiPHP Manager.
- Faça a troca no nível certo: domínio principal para o site, cada subdomínio individualmente se ele tiver versão própria.
- Rode a página de teste nos caminhos inventariados.
- Depois de migração ou instalação de sistema em subpasta, repita o
grep. Handler novo aparecendo é o sinal de que algo vai divergir na próxima troca. - Registre no documento do cliente qual versão vale em cada caminho e por quê.
Guardar essa saída por cliente transforma a próxima atualização de PHP em tarefa de minutos, porque você já sabe quais pastas são exceção.
O que dizer ao cliente quando uma pasta ficou com outra versão
O cliente costuma perguntar por que pagou para atualizar o PHP e a loja ou o blog continuam com aviso de versão antiga. Uma frase que funciona:
Se a subpasta ficou na versão antiga de propósito, a frase muda: "A loja roda num sistema que ainda não é compatível com a versão nova. Mantivemos ela na versão anterior até a atualização do sistema, e o resto do site já está na nova." Isso evita que o cliente ache que o serviço ficou pela metade e abre espaço para orçar a atualização do sistema da subpasta.
Quando o problema não é herança
Se a página de teste mostra a versão certa em todos os caminhos e o site ainda reclama, a herança está resolvida e a causa é outra. Verifique o cache (plugin, servidor ou CDN), o aviso de versão gravado no banco por algum plugin que só atualiza na próxima verificação, e cron jobs. Pela nossa prática de operação (a documentação de herança não trata disso), tarefas agendadas rodam pelo PHP de linha de comando, que pode ser diferente do PHP que atende o navegador. Nesse caso, ajuste o caminho do binário no comando do cron em vez de mexer no .htaccess. Se nada disso explicar, a definição pode estar no nível do servidor, e aí a conversa é com o suporte da hospedagem, levando a saída da página de teste de cada caminho.
Referências
- Documentação oficial (cpanel) — PHP Inheritance (EasyApache 4). Consultado em 2026-11-01.