# 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.

> 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.

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

---

## 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](https://docs.cpanel.net/ea4/php/php-inheritance/) 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.ini` nas pastas. Um `php.ini` solto na raiz de documentos ou numa subpasta não é lido nesse modo. O `.user.ini` é relido em intervalos definidos por `user_ini.cache_ttl` (300 segundos por padrão), então a mudança pode levar alguns minutos para aparecer. `php_value` no `.htaccess` não funciona nesse modo e costuma gerar erro 500.
- `cgi-fcgi`: o PHP pode ler um `php.ini` do domínio ou do diretório, além do `.user.ini`. `php_value` no `.htaccess` também não funciona aqui.
- `apache2handler` (DSO): valem `php_value` e `php_flag` no `.htaccess`. O `.user.ini` é ignorado.
- `litespeed` (LSAPI): em geral aceita `php_value` e `php_flag` no `.htaccess` além de `php.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
<?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:

```bash
# 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 `.htaccess` antigos 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 `.htaccess` e 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 `.htaccess` na 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 `.htaccess` da 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 eliminar `php.ini`, `.user.ini` ou linhas `php_value` esquecidos 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 `grep` e o `find` acima 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:

> **** "A versão do PHP no servidor é definida por pasta. Atualizamos o site principal, e a área da loja tinha uma configuração própria antiga que continuava valendo só nela. Já alinhamos as duas e testamos cada endereço."

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.

