Base de Conhecimento

6.10 Como usar o handler server-parsed

O handler server-parsed faz o Apache processar arquivos com server-side includes, em vez de tratá-los apenas como conteúdo estático comum.

Na prática, ele é usado quando você quer que uma extensão personalizada funcione como arquivo com SSI, permitindo inclusões e processamento pelo servidor.

Como acessar o cPanel

Antes de configurar, 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 do serviço

O acesso normalmente exige o login da hospedagem.

Como usar o handler server-parsed

O que esse handler faz

O server-parsed instrui o Apache a analisar o arquivo para server-side includes.

Em outras palavras, o servidor passa a interpretar o conteúdo em busca das instruções SSI suportadas e monta a resposta antes de enviá-la ao navegador.

Esse handler é útil quando você quer usar SSI em uma extensão diferente da tradicional, como em projetos antigos ou personalizados.

Quando usar

Use esse handler quando:

um site antigo depende de SSI
você quer manter uma extensão personalizada
renomear todos os arquivos para .shtml não é viável

Exemplos de extensões que poderiam ser associadas:

pagina
incpage
shtml2

Esse tipo de configuração ajuda a manter compatibilidade sem alterar toda a base de arquivos do site.

Passo 1 – Abrir Apache Handlers

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

Passo 2 – Informar o handler

No campo Handler, digite:

server-parsed

Tradução útil:

server-parsed = processado pelo servidor

Passo 3 – Informar a extensão

No campo Extension(s), digite a extensão que deverá ser processada com SSI.

Exemplo:

pagina

Com isso, arquivos como home.pagina poderão receber o tratamento do handler server-parsed.

A extensão escolhida deve ser usada apenas nos arquivos que realmente precisam desse processamento.

Passo 4 – Salvar a associação

Clique em Add para registrar a regra.

Passo 5 – Testar um arquivo de exemplo

Depois da configuração, crie ou use um arquivo com a extensão cadastrada e acesse sua URL.

Observe se o conteúdo está sendo montado como esperado pelo servidor.

Se o resultado final exibir diretivas SSI literalmente ou não processar o conteúdo, revise a associação, a sintaxe usada no arquivo e as limitações do ambiente.

Exemplos de uso prático

reaproveitar cabeçalhos em várias páginas
reaproveitar rodapés comuns do site
manter compatibilidade com páginas antigas feitas com SSI
usar uma extensão própria para páginas processadas pelo servidor

Esse handler pode ser útil para projetos legados que ainda não foram convertidos para um modelo mais moderno de templates.

Cuidados importantes

não aplique esse handler em extensões que deveriam ser estáticas
evite misturar funções do site sem necessidade
teste sempre o resultado final da página
confirme se o ambiente de hospedagem aceita esse uso conforme o esperado

Se usado de forma errada, o site pode exibir conteúdo incorreto, não processar instruções ou apresentar comportamento diferente do esperado.

Resultado esperado

Ao final, arquivos com a extensão escolhida passarão a ser processados com o handler server-parsed, permitindo o uso de SSI naquela extensão.

Isso facilita manter aplicações antigas ou extensões personalizadas com comportamento semelhante ao de arquivos tradicionalmente usados para SSI.

Resumo

O handler server-parsed serve para fazer o Apache processar arquivos com server-side includes.

Passos básicos:
1. abrir Apache Handlers
2. informar server-parsed
3. informar a extensão desejada
4. adicionar a regra
5. testar a página no navegador

É o handler ideal quando você quer aplicar SSI a uma extensão personalizada.

Se precisar, depois eu também posso te montar um tutorial separado só sobre SSI no Apache com exemplos práticos para clientes finais.

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

0 Usuários acharam útil