6.06 Como entender os handlers nativos disponíveis no cPanel

A ferramenta Apache Handlers do cPanel trabalha com alguns handlers nativos do Apache, que representam formas diferentes de o servidor tratar arquivos e respostas.
Na prática, entender esses handlers ajuda a escolher corretamente qual comportamento aplicar a uma extensão personalizada e evita configurações erradas que podem quebrar o site.

Como acessar o cPanel

Antes de consultar essa área, 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 de acesso ao cPanel
Tenha o login da hospedagem em mãos para entrar na conta.

Como entender os handlers nativos disponíveis no cPanel

O que são handlers nativos

Handlers nativos são comportamentos já conhecidos pelo Apache e disponibilizados pela interface para uso na associação com extensões de arquivos.

Em vez de criar um mecanismo do zero, você reutiliza um tratamento já existente no servidor.

O grande benefício é que você pode adaptar extensões personalizadas usando funcionalidades já suportadas pelo Apache.

Lista dos handlers que costumam aparecer

Entre os handlers nativos mais conhecidos nesta interface estão:

  • default-handler
  • send-as-is
  • cgi-script
  • imap-file
  • server-info
  • server-parsed
  • server-status
  • type-map
Mesmo que todos apareçam na documentação, nem todos são igualmente úteis no dia a dia do cliente final em hospedagem compartilhada.

Entendendo cada um de forma simples

1. default-handler

É o tratamento padrão de conteúdo estático do Apache.

Em geral, faz o servidor entregar o arquivo normalmente, como ocorre com arquivos comuns quando não existe outro processamento especial.


2. send-as-is

Faz o Apache enviar o arquivo com cabeçalhos HTTP já presentes no próprio conteúdo.

É um uso mais técnico e específico, normalmente voltado a cenários especiais.


3. cgi-script

Faz o Apache tratar o arquivo como script CGI.

É útil em aplicações antigas, scripts legados e extensões personalizadas que precisam de execução como CGI.


4. imap-file

Relaciona-se a arquivos de regra de imagemap.

É um uso mais antigo e pouco comum em projetos modernos.


5. server-info

Relaciona-se à obtenção de informações de configuração do servidor.

Em hospedagem compartilhada, isso tende a ser menos relevante para uso cotidiano do cliente final.


6. server-parsed

Faz o Apache processar o arquivo com server-side includes.

É útil quando você deseja que determinada extensão funcione como páginas com SSI.


7. server-status

Relaciona-se à obtenção de status do servidor.

Assim como server-info, é mais técnico e não costuma ser o uso mais comum para páginas normais do site.


8. type-map

Trata o arquivo como type map file, ligado a negociação de conteúdo.

É um caso mais específico e menos frequente para uso comum em hospedagem tradicional.

Na prática, os handlers que mais costumam despertar interesse em tutoriais de cliente final são cgi-script e server-parsed.

Traduções úteis

  • default-handler = tratamento padrão
  • send-as-is = enviar como está
  • cgi-script = tratar como script CGI
  • imap-file = arquivo de imagem mapeada
  • server-info = informações do servidor
  • server-parsed = processado pelo servidor
  • server-status = status do servidor
  • type-map = mapa de tipos

Como escolher o handler certo

Ao decidir qual handler usar, pense no resultado desejado:

  • quer execução de script? cgi-script
  • quer SSI? server-parsed
  • quer tratamento estático? default-handler
  • está lidando com um caso muito específico de cabeçalhos ou mapeamento? avalie se realmente faz sentido usar send-as-is, imap-file ou type-map
Escolher o handler apenas pelo nome, sem entender o efeito, é um erro comum. O ideal é sempre partir do comportamento desejado e só depois selecionar o handler.

Exemplos práticos

  • um sistema antigo usa .appcgi e precisa rodar como CGI → usar cgi-script
  • um site usa .pagina e precisa processar SSI → usar server-parsed
  • um arquivo comum deve ser entregue sem execução especial → geralmente default-handler
Entender os handlers nativos reduz erros e facilita muito a criação das associações corretas no cPanel.

Resultado esperado

Ao final, você compreenderá o papel de cada handler listado na ferramenta e terá mais segurança para decidir qual usar em cada cenário.

Isso ajuda a evitar configurações erradas e melhora a compatibilidade de aplicações legadas com sua hospedagem.

Resumo

Os handlers nativos do Apache representam diferentes formas de o servidor tratar arquivos.

Os mais importantes para entender no uso prático do cPanel costumam ser:
1. default-handler = tratamento padrão
2. cgi-script = execução como CGI
3. server-parsed = processamento com SSI

Os demais também existem, mas costumam atender cenários mais técnicos ou específicos.
Se quiser, eu também posso te entregar depois uma versão resumida só com “o que usar em cada caso” para virar artigo de apoio ou FAQ.

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

  • 0 Usuários acharam útil
Esta resposta lhe foi útil?

Artigos Relacionados

6.01 Como acessar e entender a ferramenta Apache Handlers no cPanel

A opção Apache Handlers do cPanel serve para associar extensões de arquivos a handlers do...

6.02 Como criar um Apache Handler no cPanel

A opção Apache Handlers do cPanel permite criar uma associação entre um handler existente do...

6.03 Como associar uma extensão de arquivo a um handler existente

A ferramenta Apache Handlers permite vincular uma extensão de arquivo a um handler já...

6.04 Como fazer o Apache tratar uma extensão como CGI script

A ferramenta Apache Handlers pode ser usada para fazer o Apache tratar uma extensão...

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