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
- 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 comopagina.html(e nãopagina.html.phpoupagina.html.txt). - 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. - Acesse o Gerenciador de Arquivos do cPanel
Faça login no seu cPanel e clique em Gerenciador de Arquivos.
- Navegue até a pasta pública
Abra a pastapublic_html(ou a subpasta onde seu site está). Lá você verá todos os arquivos do seu site, incluindo opagina.html. - Verifique o tipo de arquivo no servidor
Clique com o botão direito no arquivopagina.htmle 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. - Confira o .htaccess (arquivo de configuração do servidor)
O arquivo.htaccesspode estar definindo como o servidor trata arquivos. Ele pode estar dizendo: “só execute PHP em arquivos .php”. - 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)).
- Encontre e edite o .htaccess
Localize o arquivo.htaccessna pastapublic_html. Clique nele com o botão direito e escolha Editar. - 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”.
- Salve as alterações
Após adicionar a linha, clique em Salvar ou Salvar Arquivo. - Teste novamente
Acesse o arquivopagina.htmlno 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