# Código PHP na tela ou .php baixando: como corrigir no cPanel

Três sintomas parecidos que se resolvem em três telas diferentes do cPanel, com a linha exata do .htaccess e o caminho de volta se o site cair.

> três causas distintas produzem o mesmo susto. Código PHP na tela ou arquivo .php baixando quase sempre é handler ausente, resolvido em Selecionar Versão do PHP ou Manipuladores do Apache. Já .html e .inc com PHP dentro exigem um AddHandler explícito, e Tipos MIME não executa nada.

João Rizzon · 2026-09-19 · Painéis

---

## Três sintomas parecidos, três telas diferentes do cPanel

Uma página que devia abrir e em vez disso mostra `<?php $conn = mysqli_connect(...` em texto puro. Um arquivo `.php` que, ao ser clicado, vira download na barra do navegador. Um `.html` com um pedaço de PHP dentro que simplesmente ignora o código e não imprime nada.

São três coisas diferentes. E cada uma tem uma tela diferente do cPanel para resolver.

| Sintoma na tela | O que está acontecendo | Onde se corrige no cPanel |
|---|---|---||
| O código-fonte PHP aparece escrito na página | O Apache está entregando o arquivo como texto, sem passar pelo PHP | Selecionar Versão do PHP / MultiPHP Manager (refaz o handler) ou, como plano B, Manipuladores do Apache |
| O arquivo `.php` é baixado em vez de abrir | O navegador recebeu um tipo de conteúdo que não sabe exibir, normalmente por um `AddType` indevido somado ao handler ausente | Tipos MIME (remover a entrada) + restaurar o handler |
| `.html`, `.htm` ou `.inc` com PHP dentro não executa | Comportamento padrão: essas extensões nunca foram associadas ao PHP | Manipuladores do Apache (criar a associação) |

A diferença conceitual que explica os três casos: **manipulador (handler) é quem processa o arquivo no servidor; tipo MIME é o rótulo que o servidor cola na resposta para o navegador saber o que fazer com ela.** Handler executa. MIME só descreve. Mexer no MIME esperando que o PHP volte a rodar não resolve por definição: muda o rótulo da resposta, não muda quem processa o arquivo.

A interface Manipuladores do Apache, segundo a [documentação oficial do cPanel](https://docs.cpanel.net/cpanel/advanced/apache-handlers/), existe justamente para controlar como o Apache trata determinados tipos de arquivo, associando uma extensão a um manipulador. É ela que grava a linha `AddHandler` no seu `.htaccess`.

## O backup do .htaccess e o plano de volta se o site cair

Uma linha errada no `.htaccess` derruba o site inteiro com erro 500, não só a página que você estava consertando. O efeito é imediato e vale para todas as pastas abaixo daquela onde o arquivo está.

Faça isto antes:

- cPanel → **Gerenciador de Arquivos** → entre em `public_html`.
- Clique em **Configurações** (canto superior direito) e marque **Mostrar Arquivos Ocultos (dotfiles)**. Sem isso o `.htaccess` não aparece.
- Clique com o botão direito no `.htaccess` → **Copiar**. A caixa que abre pede um caminho de destino, não um nome: digite `/public_html` e confirme.
- Na lista da pasta aparece um segundo arquivo, com nome do tipo `.htaccess (copy)` ou `.htaccess-copy`, conforme a versão do painel. Clique com o botão direito nele → **Renomear** e dê um nome sem o ponto inicial, por exemplo `htaccess-backup-2026-09-19`. Sem o ponto, o arquivo deixa de ser lido pelo Apache e continua visível na lista mesmo que você volte a ocultar os dotfiles.

Se preferir guardar fora do servidor, selecione o `.htaccess` e clique em **Download**. As duas opções servem, e nada impede fazer as duas.

Plano de volta, se o site sair do ar depois da edição:

- Se a linha veio da interface **Manipuladores do Apache**, apague o manipulador ali mesmo, pelo ícone de lixeira ao lado da entrada na lista de manipuladores definidos pelo usuário. Um clique, sem editar arquivo.
- Se você editou o `.htaccess` na mão, apague o arquivo atual e renomeie `htaccess-backup-2026-09-19` de volta para `.htaccess`.
- Se nem isso resolver, renomeie o `.htaccess` para `.htaccess-desativado`. O site volta sem as regras (perde redirecionamentos e permalinks bonitos do WordPress, mas volta). Depois você recoloca as regras aos poucos.

No WordPress, guarde uma regra de convivência: nunca escreva nada entre `# BEGIN WordPress` e `# END WordPress`. O próprio WordPress reescreve esse trecho quando você salva os links permanentes e apaga o que estiver lá dentro. O mesmo vale para o bloco gerado pelo cPanel, que vem marcado com `do not edit`. Suas linhas vão **antes ou depois** desses blocos.

## Quando o código PHP aparece escrito na página

É o mais assustador, porque o visitante passa a ver senha de banco de dados, caminho de pastas e lógica da aplicação. Trate como incidente de segurança: se o `wp-config.php` foi exposto publicamente, troque a senha do banco depois de consertar.

O que aconteceu: o Apache entregou o arquivo `.php` como se fosse texto. Ou seja, ninguém disse a ele que aquela extensão deve ser processada pelo PHP.

### O bloco de handler que sumiu do .htaccess

É o item mais barato de testar e o mais fácil de desfazer, por isso vem antes dos outros. Quando você escolhe a versão do PHP no cPanel, o painel grava no `.htaccess` da pasta um bloco parecido com este (**exemplo**, o número da versão muda conforme o que está instalado no servidor):

```
# php -- BEGIN cPanel-generated handler, do not edit
# Set the "ea-php82" package as the default "PHP" programming language.
<IfModule mime_module>
  AddHandler application/x-httpd-ea-php82 .php .php8 .phtml
</IfModule>
# php -- END cPanel-generated handler, do not edit
```

Esse bloco pode sumir por motivos banais: alguém colou um `.htaccess` antigo por cima, um plugin de cache reescreveu o arquivo, ou o site foi migrado de outro servidor com um `.htaccess` que citava uma versão de PHP que não existe aqui.

### A correção em três cliques em Selecionar Versão do PHP

- cPanel → **Software** → **Selecionar Versão do PHP** (em algumas contas aparece como **MultiPHP Manager**).
- Escolha o domínio.
- Selecione a versão atual, salve. Depois selecione novamente a versão desejada e salve outra vez.

Esse vai e volta força o painel a reescrever o bloco de handler no `.htaccess` da pasta do domínio. Se o bloco ausente era o problema, o site volta nesse passo, sem você digitar uma linha sequer.

Se depois de salvar o bloco não aparecer no `.htaccess`, confira se existe um `.htaccess` em uma subpasta sobrescrevendo o da raiz. O Apache aplica o arquivo mais próximo do conteúdo.

### Recriar o handler do .php em Manipuladores do Apache

Quando o vai e volta não grava nada (permissão de escrita ruim no `.htaccess`, ou outro `.htaccess` mais interno mandando na pasta), dá para registrar a associação do `.php` na mão:

- cPanel → **Avançado** → **Manipuladores do Apache**.
- Campo **Manipulador (Handler)**: o nome exato do handler PHP deste servidor, do tipo `application/x-httpd-ea-php82`. Copie de um `.htaccess` da própria conta onde o PHP roda normalmente, na linha `AddHandler` do bloco gerado pelo cPanel.
- Campo **Extensão(ões)**: `.php`
- Clique em **Adicionar** e teste o site.

Dois cuidados. Primeiro, prefira sempre o Selecionar Versão do PHP, que grava o nome certo sozinho. Segundo, uma entrada criada na mão continua apontando para a mesma versão quando o servidor atualiza o PHP, e aí o sintoma volta exatamente igual. Se usar este caminho, anote que ele existe e revise a entrada depois de qualquer troca de versão.

### Tag curta e nome do arquivo, as duas causas que ninguém verifica

- **Tag curta.** Um arquivo que começa com `<?` em vez de `<?php` não roda se a diretiva `short_open_tag` estiver desligada, e ela vem desligada por padrão nas versões recentes. O sintoma é idêntico: código na tela. A correção é trocar `<?` por `<?php` no arquivo, não mexer em handler.
- **Nome do arquivo, ao contrário do que muita gente supõe.** Com `AddHandler`, o Apache considera todas as extensões do nome, não só a última, e o casamento ignora maiúsculas e minúsculas. `PAGINA.PHP` executa, e `relatorio.php.txt` também executa, porque o `.php` está lá no meio. Isso é um risco conhecido: um formulário que aceita upload de `.txt` pode receber `foto.php.txt` e rodar código. Se a sua pasta de uploads aceita arquivo de visitante, crie um `.htaccess` dentro dela com o bloco abaixo, que nega acesso a qualquer nome contendo `.php`, `.php7`, `.phtml` e variantes em qualquer posição:

```
<FilesMatch "\.ph(p[0-9]?|tml)">
  Require all denied
</FilesMatch>
```

O nome só explica o sintoma "código na tela" no caso inverso: arquivo salvo com uma extensão que o handler não cobre, como `pagina.php5` quando a linha `AddHandler` lista apenas `.php .php8 .phtml`, ou arquivo sem extensão nenhuma. Confira o nome exato no Gerenciador de Arquivos antes de mexer em configuração.

## Quando o .php vira download em vez de abrir

Aqui o navegador recebeu a resposta e concluiu que aquilo é um arquivo para salvar, não uma página para desenhar. Duas condições produzem esse resultado, e elas podem estar somadas: o handler ausente (mesmo problema do sintoma 1) e algum `AddType` que rotula `.php` como um tipo binário, do tipo `application/octet-stream`. Esse `AddType` costuma ser resto de uma tentativa antiga de forçar download de arquivos em uma pasta.

### Ler o content-type no DevTools ou no curl para saber qual é a causa

No navegador, abra as **Ferramentas do Desenvolvedor** (F12), aba **Rede** (Network), recarregue a página e clique na primeira linha da lista. Procure o cabeçalho `content-type` na resposta.

- `text/html` com código PHP visível na tela: handler ausente. Vá para o sintoma 1.
- `text/plain`: handler ausente e o servidor rotulou como texto puro.
- `application/octet-stream` ou `application/x-httpd-php`: existe um `AddType` mandando o navegador baixar.

Se preferir terminal, o mesmo dado sai daqui:

```
curl -sI https://seudominio.com.br/pagina.php
```

A flag `-s` esconde a barra de progresso e `-I` pede só os cabeçalhos. Você vai ver algo como `HTTP/2 200` e uma linha `content-type:`. É essa linha que interessa.

### Remover o AddType indevido em Tipos MIME

- cPanel → **Avançado** → **Tipos MIME**. Role até a lista de **Tipos MIME definidos pelo usuário**.
- Procure qualquer entrada que cite `.php`, `php5`, `phtml` ou `octet-stream`. Apague com o ícone de lixeira. As entradas definidas pelo sistema não podem ser removidas, e nem precisam.
- Volte em **Selecionar Versão do PHP** e refaça o procedimento do sintoma 1 para garantir que o handler esteja no lugar.
- Teste em uma aba anônima. O navegador guarda o tipo de conteúdo em cache e pode continuar baixando mesmo depois do conserto.

Um detalhe que economiza discussão: `AddType` nunca vai fazer o PHP rodar. Ele muda o rótulo da resposta, e só. Se o arquivo não passa pelo interpretador, mudar o MIME apenas troca "código na tela" por "download".

## Por que .html, .htm e .inc com PHP dentro nunca executam

Esse não é defeito. É o comportamento padrão. O Apache só manda para o PHP as extensões listadas no handler, e `.html` não está lá.

Acontece quando você quer inserir um trecho dinâmico em uma página estática antiga, ou quando herda um site legado cheio de `include('funcoes.inc')`.

### Criar o manipulador das extensões extras em Manipuladores do Apache

- cPanel → **Avançado** → **Manipuladores do Apache**.
- No campo **Manipulador (Handler)**, digite o nome do manipulador PHP do servidor.
- No campo **Extensão(ões)**, digite as extensões separadas por espaço, com o ponto: `.html .htm`.
- Clique em **Adicionar**. A entrada passa a aparecer na lista de manipuladores definidos pelo usuário, com o botão de exclusão ao lado.

O nome do manipulador é o ponto delicado. Ele varia conforme a versão do PHP instalada no servidor (`application/x-httpd-ea-php74`, `ea-php81`, `ea-php82` e assim por diante). **Não copie o nome deste artigo.** Abra o `.htaccess` da pasta do seu site e copie o nome exato que aparece na linha `AddHandler` do bloco gerado pelo cPanel. Se o bloco não existir, force a regravação pelo Selecionar Versão do PHP, como no sintoma 1, e então copie.

A linha resultante no `.htaccess`, escrita pela interface, tem este formato:

```
AddHandler application/x-httpd-ea-php82 .html .htm
```

Ela fica no `.htaccess` da pasta onde você está, e vale para essa pasta e todas as subpastas. Se você quer o comportamento só em uma área do site, crie o `.htaccess` dentro daquela pasta em vez de mexer no da raiz.

Dois efeitos colaterais de mandar `.html` para o PHP, que valem a decisão consciente: todo HTML estático do site passa a ser processado pelo interpretador (gasta mais CPU por requisição) e alguns caches de página deixam de servir esses arquivos como estáticos. Se for só uma página, isole em uma subpasta.

### O .inc que entrega senha de banco em texto puro

Arquivo `.inc` com PHP dentro é perigoso por outro motivo: se alguém acessar `https://seusite.com.br/config.inc` direto no navegador, o servidor devolve o conteúdo em texto. Conexão de banco, chave de API, tudo.

Duas saídas, nesta ordem de preferência:

- **Renomear para `.php`** e ajustar os `include` que apontam para ele. É a solução definitiva e não depende de nenhuma configuração de servidor.
- Se não der para renomear, bloqueie o acesso direto acrescentando ao `.htaccess`:

```
<FilesMatch "\.inc$">
  Require all denied
</FilesMatch>
```

O bloco acima faz o Apache responder 403 para qualquer pedido de arquivo terminado em `.inc`, sem impedir que o PHP inclua esse arquivo internamente. Em servidores com Apache 2.2, a sintaxe é `Deny from all` no lugar de `Require all denied`. Se a linha der erro 500, é esse o motivo, e aí vale voltar ao backup e usar a opção 1.

### Com PHP-FPM ligado, o AddHandler pode não surtir efeito

Quando o domínio está com PHP-FPM ligado, o encaminhamento do PHP não é feito por `AddHandler` no `.htaccess`, e sim por uma configuração de proxy no nível do Apache. Nesses casos, adicionar `.html` pela interface Manipuladores do Apache pode não surtir efeito nenhum: a linha entra no arquivo e o `.html` continua saindo estático.

O teste é direto: adicione o handler, teste, e se nada mudar, desative o PHP-FPM para aquele domínio em MultiPHP Manager e teste de novo, ou peça ao suporte da sua hospedagem a associação no nível do servidor. Não insista editando o `.htaccess` várias vezes.

## Como confirmar com um arquivo de teste que o PHP voltou a rodar

Não confie na página inicial. Ela pode estar vindo do cache do plugin, do cache do navegador ou do CDN.

- No Gerenciador de Arquivos, dentro de `public_html`, clique em **+ Arquivo** e crie `teste-handler.php`.
- Clique com o botão direito no arquivo → **Editar** e cole exatamente:

```
<?php echo "PHP rodando: " . PHP_VERSION;
```

- Salve e abra `https://seudominio.com.br/teste-handler.php` em uma **aba anônima**.

Resultado esperado: a frase `PHP rodando:` seguida do número da versão, por exemplo `8.2.20`. Isso prova duas coisas de uma vez, que o handler está ativo e qual versão está respondendo.

Se aparecer o código-fonte na tela, o handler continua ausente. Se o arquivo for baixado, ainda há `AddType` indevido.

Para testar o sintoma 3, repita com um arquivo `teste-handler.html` contendo o mesmo conteúdo. Ele só vai imprimir a frase se o `AddHandler` das extensões extras tiver pegado.

**Apague os dois arquivos de teste depois.** Eles revelam a versão exata do PHP para qualquer um que adivinhe o nome. E nunca use `phpinfo()` em arquivo público pelo mesmo motivo: ele expõe caminhos, módulos e configuração inteira do servidor.

## Ordem de verificação, do passo reversível ao que exige edição

A ordem abaixo vem da lógica do diagnóstico, não de levantamento de causas: começa pelo passo reversível e barato, e só depois vai para o que exige edição. Pare no primeiro passo que resolver.

| Ordem | O que fazer | Tempo | Risco |
|---|---|---|---||
| 1 | Copiar o `.htaccess` atual para um arquivo de backup | 1 min | nenhum |
| 2 | Abrir DevTools → Rede e ler o `content-type` da resposta | 1 min | nenhum |
| 3 | Selecionar Versão do PHP: salvar outra versão e voltar para a original | 2 min | baixo, o painel reescreve só o bloco dele |
| 4 | Tipos MIME: remover entradas de usuário citando `.php` ou `octet-stream` | 2 min | baixo, removível com um clique |
| 5 | Manipuladores do Apache: criar a associação para `.php` (plano B), `.html`, `.htm` ou `.inc` | 3 min | médio, testar logo depois |
| 6 | Se der 500: apagar o manipulador pela lixeira ou restaurar o backup | 1 min | nenhum |

Dois resultados que interrompem essa sequência, e o que fazer com cada um:

- **Erro 500 logo após salvar o handler.** Suspeite do nome do manipulador: escrito errado, ou citando uma versão de PHP que não existe neste servidor. Apague a entrada em Manipuladores do Apache e confira o nome no bloco gerado pelo cPanel.
- **Nada muda, mesmo com tudo aparentemente certo.** Teste em aba anônima e, se o site usa Cloudflare ou plugin de cache, limpe o cache antes de concluir que a correção falhou. Se o domínio usa PHP-FPM, releia o aviso do sintoma 3.

## O que sustenta este artigo, e o que ele não mediu

Este texto é documental. O comportamento das interfaces **Manipuladores do Apache**, **Tipos MIME** e **Selecionar Versão do PHP** está descrito conforme a [documentação oficial do cPanel sobre Apache Handlers](https://docs.cpanel.net/cpanel/advanced/apache-handlers/), consultada em 17 de setembro de 2026, e conforme o comportamento padrão das diretivas `AddHandler` e `AddType` do Apache.

Não houve medição de laboratório para este artigo. Nenhum número de tempo de resposta, taxa de ocorrência ou comparação entre servidores é afirmado aqui, porque não foi levantado. A ordem sugerida de verificação é critério de custo e reversibilidade, não estatística de causa.

Os nomes de manipulador do tipo `application/x-httpd-ea-php82` e os exemplos de domínio e arquivo são **exemplos**, não parâmetros universais. O nome válido é o que está no `.htaccess` da sua própria conta, e ele muda conforme a versão do PHP instalada. Copie de lá, não daqui.

