blog
Painéis

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.

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

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
  1. A regra que explica quase todos os casos
  2. Em que ordem servidor, domínio, subdomínio e subpasta se aplicam
  3. Como saber qual PHP vale em cada caminho
  4. Encontrando o arquivo que está sobrescrevendo
  5. Como manter a mesma versão de PHP em vários sites
  6. O que dizer ao cliente quando uma pasta ficou com outra versão
  7. 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:

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.

Onde procurar o PHP que está valendoPágina de teste mostra versão erradaSubdomínio ou domínio adicional?Ajustar pelo MultiPHP ManagerSubpasta: procurar handler no .htaccessRemover bloco antigo após cópiaRepetir a página de teste
Caminho de diagnóstico quando um endereço não segue a versão do domínio principal.

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:

Como corrigir sem quebrar outra coisa

  1. 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.
  2. Para subdomínios e domínios adicionais, ajuste pelo MultiPHP Manager, não editando o .htaccess na mão. O painel grava o handler correto para o servidor.
  3. Para subpastas comuns que devem seguir o domínio, remova o bloco de handler do .htaccess da subpasta (faça cópia antes). Sem definição local, ela volta a herdar.
  4. 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 eliminar php.ini, .user.ini ou linhas php_value esquecidos em subpastas, a menos que existam por motivo conhecido.
  5. 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:

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.

Processo para trocar PHP sem divergênciaInventariar definições locaisRodar grep e find e salvar a saídaListar subdomínios e seus modosInherit ou versão fixaTrocar no nível certoDomínio principal ou subdomínioTestar caminhos inventariadosPágina de teste em cada endereçoRegistrar no documento do clienteVersão e motivo de cada caminho
Ordem de trabalho para qualquer troca de versão de PHP em vários sites.

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

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