blog
Painéis

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.

JR · · 13 min de leitura · 2 tabelas · 6 blocos de código

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
  1. Três sintomas parecidos, três telas diferentes do cPanel
  2. O backup do .htaccess e o plano de volta se o site cair
  3. Quando o código PHP aparece escrito na página
  4. Quando o .php vira download em vez de abrir
  5. Por que .html, .htm e .inc com PHP dentro nunca executam
  6. Como confirmar com um arquivo de teste que o PHP voltou a rodar
  7. Ordem de verificação, do passo reversível ao que exige edição
  8. 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.

Do sintoma na tela para a tela do cPanelCódigo PHP na telaHandler ausente, refaça a versão do PHPArquivo .php baixaAddType indevido em Tipos MIME.html com PHP não rodaExtensão fora do handler, crie associaçãoConfirme pelo content-typeDevTools, aba Rede, cabeçalho da resposta
Handler executa o arquivo, tipo MIME só rotula a resposta.

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:

  1. cPanel → Gerenciador de Arquivos → entre em public_html.
  2. Clique em Configurações (canto superior direito) e marque Mostrar Arquivos Ocultos (dotfiles). Sem isso o .htaccess não aparece.
  3. 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.
  4. 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:

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

  1. cPanel → Software → Selecionar Versão do PHP (em algumas contas aparece como MultiPHP Manager).
  2. Escolha o domínio.
  3. 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:

  1. cPanel → Avançado → Manipuladores do Apache.
  2. 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.
  3. Campo Extensão(ões): .php
  4. 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

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

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

  1. cPanel → Avançado → Tipos MIME. Role até a lista de Tipos MIME definidos pelo usuário.
  2. 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.
  3. Volte em Selecionar Versão do PHP e refaça o procedimento do sintoma 1 para garantir que o handler esteja no lugar.
  4. 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

  1. cPanel → Avançado → Manipuladores do Apache.
  2. No campo Manipulador (Handler), digite o nome do manipulador PHP do servidor.
  3. No campo Extensão(ões), digite as extensões separadas por espaço, com o ponto: .html .htm.
  4. 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:

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

  1. No Gerenciador de Arquivos, dentro de public_html, clique em + Arquivo e crie teste-handler.php.
  2. Clique com o botão direito no arquivo → Editar e cole exatamente:
<?php echo "PHP rodando: " . PHP_VERSION;
  1. 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:

Ordem de verificação, do reversível ao que edita arquivoBackupCopiar o .htaccess antes de tudoDiagnósticoLer o content-type no DevToolsVersão do PHPSalvar outra versão e voltarTipos MIMERemover entradas de usuário indevidasManipuladoresCriar associação e testar logo depois
Ordem por custo e reversibilidade. Pare no passo que resolver.

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

  1. Documentação oficial (cpanel) — Apache Handlers. Consultado em 2026-09-17.
Leia também