Base de Conhecimento

6.05 Como configurar uma extensão para server-side includes

A ferramenta Apache Handlers pode ser usada para fazer o Apache processar uma extensão com server-side includes, usando o handler server-parsed.

Na prática, isso permite que arquivos com uma extensão personalizada sejam processados com instruções SSI, como inclusões de conteúdo e comandos próprios do servidor.

Como acessar o cPanel

Acesse o cPanel por uma destas formas:

https://seudominio.com.br/cpanel
https://seudominio.com.br:2083
pela área do cliente MyWay, usando o atalho para o cPanel

Tenha seu usuário e senha da hospedagem disponíveis para o login.

Como configurar uma extensão para server-side includes

O que são server-side includes

Server-side includes, também chamados de SSI, são instruções inseridas no arquivo para que o servidor monte partes do conteúdo na hora da resposta.

Isso pode ser usado, por exemplo, para:

incluir trechos de outro arquivo
mostrar data de modificação
exibir tamanho de arquivos
inserir saídas geradas por determinados recursos do servidor

Traduções úteis:

Server-Side Includes = Inclusões do lado do servidor
server-parsed = arquivo processado pelo servidor

Esse recurso é mais comum em cenários legados, sites antigos ou páginas que ainda usam SSI para montar partes do conteúdo.

Quando essa configuração faz sentido

Normalmente ela é útil quando:

o site usa uma extensão diferente de .shtml
você quer manter um padrão próprio, como .incpage ou .htmlssi
há muitos arquivos antigos e renomear tudo seria trabalhoso

Em vez de alterar todos os nomes de arquivos, você pode associar a extensão personalizada ao handler server-parsed.

Passo 1 – Acessar Apache Handlers

No cPanel, vá em Avançado e clique em Apache Handlers.

Passo 2 – Informar o handler correto

No campo Handler, digite:

server-parsed

Esse é o handler responsável por fazer o Apache processar o arquivo para SSI.

Com esse handler, o servidor deixa de tratar o arquivo apenas como conteúdo estático e passa a analisar diretivas SSI presentes nele.

Passo 3 – Informar a extensão que deverá usar SSI

No campo Extension(s), digite a extensão personalizada desejada.

Exemplos:

shtml2
incpage
htmlssi

Se você definir incpage, um arquivo como topo.incpage poderá ser processado com SSI.

A extensão é apenas a “chave” que fará o Apache aplicar o handler server-parsed naquele tipo de arquivo.

Passo 4 – Adicionar a associação

Depois de preencher os campos, clique em Add.

Tradução útil:

Add = Adicionar

Passo 5 – Criar ou testar um arquivo compatível

Depois da configuração, teste um arquivo com a extensão escolhida.

Exemplo de cenário prático:

arquivo: pagina.incpage
dentro dele, conteúdo HTML com diretivas SSI compatíveis
acesso pela URL da página

Se o ambiente estiver compatível, o Apache deverá processar o arquivo com o comportamento de SSI.

Nem todo recurso relacionado a SSI será necessariamente permitido em toda hospedagem. Por isso, é importante validar o comportamento real no ambiente do site.

Exemplos de uso no dia a dia

incluir um cabeçalho comum em várias páginas
incluir um rodapé reaproveitado em diversos arquivos
mostrar determinadas informações processadas pelo servidor
manter compatibilidade com um site antigo que depende de SSI

Esse tipo de configuração pode ser útil principalmente em migrações de sites legados.

Cuidados importantes

não use SSI sem necessidade em páginas que poderiam ser estáticas
teste impacto e resultado final no navegador
mantenha o conteúdo organizado para evitar páginas difíceis de manter
confirme se a extensão escolhida não conflita com outros usos do site

Se a configuração estiver errada, a página pode exibir as instruções literalmente, deixar de processar o conteúdo ou apresentar comportamento inesperado.

Resultado esperado

Ao final, a extensão configurada deverá ser tratada com server-side includes, permitindo ao Apache processar esse tipo de arquivo com o handler server-parsed.

Isso facilita manter extensões personalizadas em projetos que dependem de SSI.

Resumo

Para configurar uma extensão para server-side includes:

1. acesse Apache Handlers
2. informe server-parsed no campo handler
3. informe a extensão personalizada
4. adicione a regra
5. teste um arquivo real com SSI

Esse recurso é útil quando você quer processar uma extensão personalizada com comportamento semelhante ao de arquivos .shtml.

Se quiser, depois eu também posso criar os artigos complementares sobre SSI, .htaccess e exemplos práticos de include no mesmo padrão visual.

Atenciosamente,
MyWay Hosting
Servidores Otimizados por inteligência artificial
www.myway.com.br

0 Usuários acharam útil