A opção Apache Handlers do cPanel serve para associar extensões de arquivos a handlers do Apache, definindo como o servidor web deve tratar determinados tipos de arquivo quando forem acessados no site.
Na prática, esse recurso é usado para fazer o Apache tratar uma extensão como CGI, processar arquivos com server-side includes ou aplicar um comportamento específico a uma nova extensão usando um handler já existente no servidor.
Como acessar o cPanel
Antes de usar a ferramenta, primeiro acesse o cPanel de uma destas formas:
- pela URL direta: https://seudominio.com.br/cpanel
- pela porta segura: https://seudominio.com.br:2083
- pela área do cliente MyWay: entre no serviço de hospedagem e use o atalho de acesso ao cPanel
O acesso normalmente exige o usuário e senha da hospedagem, exceto quando a área do cliente oferece login automático.
Como acessar e entender a ferramenta Apache Handlers no cPanel
Para que serve esta opção
O recurso Apache Handlers existe para controlar como o Apache vai lidar com determinadas extensões de arquivos.
Em vez de o servidor tratar tudo apenas como arquivo comum, você pode informar que uma extensão específica deve ser interpretada com um handler já disponível.
Isso é útil em cenários como:
- usar uma extensão personalizada para arquivos CGI
- fazer o Apache processar uma extensão com server-side includes
- padronizar um comportamento específico para arquivos de uma aplicação antiga
- ajustar compatibilidade de scripts que dependem de uma extensão diferente da convencional
Esse recurso não cria um novo módulo do Apache. Ele apenas associa uma extensão a um handler existente no servidor.
Onde encontrar no cPanel
Depois de entrar no cPanel, localize a seção Avançado e clique em Apache Handlers.
Traduções úteis:
- Advanced = Avançado
- Apache Handlers = Manipuladores do Apache ou Apache Handlers
- Handler = manipulador ou tratamento
- Extension = extensão
Ao abrir a interface, você verá a área para adicionar um handler e, em muitos casos, a lista de handlers definidos pelo usuário.
O que é um handler, em linguagem simples
Um handler é o mecanismo que informa ao Apache o que fazer com um arquivo quando alguém acessa sua URL.
Dependendo do handler configurado, o servidor pode:
- entregar o arquivo como conteúdo estático
- executar o arquivo como script
- processar instruções internas do servidor
- enviar o conteúdo com cabeçalhos HTTP já presentes no próprio arquivo
Em outras palavras, a extensão do arquivo pode deixar de ser apenas “nome do arquivo” e passar a determinar como o Apache vai processá-lo.
O que existe dentro da ferramenta
Ao entrar em Apache Handlers, normalmente você encontra:
- um campo para informar o Handler
- um campo para informar a Extension
- um botão para adicionar a associação
- uma tabela com handlers definidos pelo usuário
- opção para remover associações personalizadas, quando aplicável
Traduções úteis:
- Handler = Handler
- Extension(s) = Extensão(ões)
- Add = Adicionar
- Remove = Remover
- Delete = Excluir
A ferramenta trabalha com extensões e não com nomes específicos de arquivos. Ou seja, a configuração vale para arquivos que usem aquela extensão.
Principais handlers que você pode encontrar
O cPanel costuma listar handlers internos conhecidos do Apache, como:
- default-handler
- send-as-is
- cgi-script
- imap-file
- server-info
- server-parsed
- server-status
- type-map
Nem todo handler será útil em hospedagem compartilhada. Em muitos casos, os mais relevantes para o cliente final são cgi-script e server-parsed.
Quando esse recurso costuma ser usado
Alguns exemplos práticos:
- um sistema antigo usa arquivos .cgiapp e você quer que o Apache trate isso como CGI
- você deseja que arquivos .inchtml sejam processados como server-side includes
- um script legado exige uma extensão diferente das convencionais
- você está migrando um site antigo e quer preservar a forma como certos arquivos eram tratados
A principal utilidade é adaptar o comportamento do servidor sem precisar renomear todos os arquivos para as extensões tradicionais.
Cuidados antes de usar
- não altere extensões sem saber como a aplicação funciona
- evite associar extensões amplamente usadas a handlers inadequados
- tenha atenção especial ao usar cgi-script, pois scripts executáveis exigem mais cuidado com segurança
- verifique se a sua hospedagem permite o uso efetivo daquele handler
- depois da alteração, teste a URL real no navegador
Uma associação errada pode fazer o site exibir conteúdo incorreto, gerar erro 500, baixar arquivos em vez de processá-los ou deixar de interpretar corretamente o que antes funcionava.
Como usar a ferramenta na prática
O processo geral é este:
- abrir Apache Handlers no cPanel
- informar o nome do handler existente
- informar a extensão que deverá usar esse tratamento
- adicionar a regra
- testar um arquivo real com essa extensão no navegador
- remover a regra se o resultado não for o esperado
A configuração correta depende do que você quer que o Apache faça com aquela extensão. Por isso, o mais importante é entender o comportamento do handler antes de aplicar.
Resultado esperado
Ao final, você terá entendido:
- o que é um Apache Handler
- onde acessar essa área no cPanel
- para que serve cada campo da interface
- em que situações o recurso pode ser útil
- quais cuidados tomar para não quebrar o comportamento do site
Com isso, você poderá usar a ferramenta com mais segurança para adaptar extensões e comportamento de arquivos no seu site.
Resumo
A ferramenta Apache Handlers do cPanel serve para associar extensões de arquivos a handlers existentes do Apache.
Na prática, ela pode ser usada para:
1. tratar arquivos como CGI
2. ativar processamento com server-side includes
3. adaptar extensões personalizadas para aplicações antigas
4. ajustar como o servidor interpreta determinados tipos de arquivo
O ponto principal é entender o que cada handler faz antes de criar a associação.
Na prática, ela pode ser usada para:
1. tratar arquivos como CGI
2. ativar processamento com server-side includes
3. adaptar extensões personalizadas para aplicações antigas
4. ajustar como o servidor interpreta determinados tipos de arquivo
O ponto principal é entender o que cada handler faz antes de criar a associação.
Caso tenha dúvidas sobre qual handler usar ou se determinada extensão pode afetar o funcionamento do site, abra um ticket de suporte antes de aplicar a alteração.
Atenciosamente,
MyWay Hosting
Servidores Otimizados por inteligência artificial
www.myway.com.br
