Como diagnosticar por que PHP não executa em arquivo .html

Como diagnosticar por que PHP não executa em arquivo .html

Olá, querido(a) cliente da GeHost! 😊

Você já tentou rodar um código PHP dentro de um arquivo com extensão .html e percebeu que nada acontece? O PHP simplesmente não executa? Calma — isso é bem comum, e o problema geralmente está em um detalhe simples de configuração. Vou te guiar, passo a passo, como descobrir e resolver isso com carinho, como um verdadeiro Sensei da hospedagem.

🔍 Primeiro: Entenda o que está acontecendo

Por padrão, o servidor da GeHost só executa código PHP em arquivos com extensão .php. Isso é uma segurança e uma convenção. Quando você tenta rodar PHP em um arquivo .html, o servidor não reconhece o conteúdo como PHP — ele o entrega como texto puro, sem processar.

Exemplo: Se seu arquivo pagina.html contém:

<?php echo "Olá, mundo!"; ?>

O que você verá no navegador será exatamente isso: o código PHP como texto. Nada executado.

🛠️ Passo a passo: Como diagnosticar e resolver

1. Verifique a extensão do arquivo
   Certifique-se de que o arquivo realmente tem a extensão .html. Às vezes, o editor de texto esconde a extensão. Abra o arquivo no seu computador e veja se ele está salvo como pagina.html (e não pagina.html.php ou pagina.html.txt).
2. Confira se o PHP está habilitado
   Em alguns casos, o PHP pode estar desativado para certos diretórios. Vamos verificar isso no Gerenciador de Arquivos.
3. Acesse o Gerenciador de Arquivos do cPanel
   Faça login no seu cPanel e clique em Gerenciador de Arquivos.

4. Navegue até a pasta pública
   Abra a pasta public_html (ou a subpasta onde seu site está). Lá você verá todos os arquivos do seu site, incluindo o pagina.html.
5. Verifique o tipo de arquivo no servidor
   Clique com o botão direito no arquivo pagina.html e escolha Editar ou Visualizar. Se o conteúdo do PHP aparecer como texto (sem ser processado), o problema é que o servidor não está interpretando PHP nele.
6. Confira o .htaccess (arquivo de configuração do servidor)
   O arquivo .htaccess pode estar definindo como o servidor trata arquivos. Ele pode estar dizendo: “só execute PHP em arquivos .php”.
7. Edite o .htaccess para permitir PHP em .html
   No Gerenciador de Arquivos, habilite a visualização de arquivos ocultos (clique em Configurações e marque Mostrar arquivos ocultos (dotfiles)).

8. Encontre e edite o .htaccess
   Localize o arquivo .htaccess na pasta public_html. Clique nele com o botão direito e escolha Editar.
9. Adicione esta linha ao arquivo
   No início do arquivo (acima de qualquer outra regra), adicione esta linha:

   AddHandler application/x-httpd-php .html

   Se já houver outras linhas, basta colocar essa no topo. Ela diz ao servidor: “Quando encontrar um arquivo .html, trate-o como PHP”.

10. Salve as alterações
    Após adicionar a linha, clique em Salvar ou Salvar Arquivo.
11. Teste novamente
    Acesse o arquivo pagina.html no navegador. Agora, o PHP deve estar funcionando!

    Dica: Se ainda não funcionar, verifique se o arquivo não tem erros de sintaxe. Um erro no PHP pode impedir a execução mesmo com a configuração correta.

💡 Dica extra do Sensei

Se você precisar que todos os arquivos HTML sejam interpretados como PHP, é possível fazer isso com uma linha no .htaccess. Mas lembre-se: isso pode afetar o desempenho e a segurança do seu site. Use com moderação!

Se mesmo após seguir todos os passos o PHP não executa, entre em contato com o nosso suporte — estamos aqui para te ajudar com um sorriso no coração. 💛

Até a próxima, com muito carinho,
Sensei da GeHost