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.

Resposta curta: 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.
Neste artigo
- Três sintomas parecidos, três telas diferentes do cPanel
- O backup do .htaccess e o plano de volta se o site cair
- Quando o código PHP aparece escrito na página
- Quando o .php vira download em vez de abrir
- Por que .html, .htm e .inc com PHP dentro nunca executam
- Como confirmar com um arquivo de teste que o PHP voltou a rodar
- Ordem de verificação, do passo reversível ao que exige edição
- O que sustenta este artigo, e o que ele não mediu
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, 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
.htaccessnã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_htmle 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 exemplohtaccess-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
.htaccessna mão, apague o arquivo atual e renomeiehtaccess-backup-2026-09-19de volta para.htaccess. - Se nem isso resolver, renomeie o
.htaccesspara.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.htaccessda própria conta onde o PHP roda normalmente, na linhaAddHandlerdo 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<?phpnão roda se a diretivashort_open_tagestiver 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<?phpno 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.PHPexecuta, erelatorio.php.txttambém executa, porque o.phpestá lá no meio. Isso é um risco conhecido: um formulário que aceita upload de.txtpode receberfoto.php.txte rodar código. Se a sua pasta de uploads aceita arquivo de visitante, crie um.htaccessdentro dela com o bloco abaixo, que nega acesso a qualquer nome contendo.php,.php7,.phtmle 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/htmlcom 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-streamouapplication/x-httpd-php: existe umAddTypemandando 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,phtmlouoctet-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
.phpe ajustar osincludeque 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 crieteste-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.phpem 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, 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.
Referências
- Documentação oficial (cpanel) — Apache Handlers. Consultado em 2026-09-17.