Base de Conhecimento

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 Apache e uma extensão de arquivo, fazendo com que o servidor trate essa extensão de uma forma específica.

Na prática, você informa o nome do handler e a extensão desejada. Depois disso, arquivos com essa extensão passam a ser tratados de acordo com o comportamento definido por esse handler.

Como acessar o cPanel

Antes de criar a associação, 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

Você precisará do usuário e senha da hospedagem, salvo quando a área do cliente disponibiliza o login automático.

Como criar um Apache Handler no cPanel

O que significa “criar um Apache Handler” nesta tela

Nesta interface, “criar” um Apache Handler significa registrar uma associação de uso entre:

um handler já conhecido pelo Apache
uma extensão de arquivo que passará a usar esse handler

Ou seja, você não está programando um novo módulo do Apache. Está apenas dizendo ao servidor que arquivos com determinada extensão devem receber um tratamento específico.

O ponto central da configuração é escolher corretamente qual handler usar e qual extensão será afetada.

Passo 1 – Abrir a ferramenta Apache Handlers

No cPanel, vá até a seção Avançado e clique em Apache Handlers.

Traduções úteis:

Advanced = Avançado
Apache Handlers = Apache Handlers

Essa é a área onde você informa o handler desejado e a extensão que será vinculada a ele.

Passo 2 – Entender os dois campos principais

Na tela, normalmente aparecem dois campos essenciais:

Handler
Extension(s)

Traduções úteis:

Handler = manipulador ou tratamento
Extension(s) = extensão(ões)

O campo Handler recebe o nome do tratamento do Apache.

O campo Extension(s) recebe a extensão que deverá usar esse tratamento.

Normalmente você informa apenas a extensão, como cgiapp, shtml2 ou outra extensão personalizada, sem precisar digitar o nome completo do arquivo.

Passo 3 – Escolher o handler correto

Antes de salvar, defina claramente o objetivo da configuração.

Exemplos:

se quer executar arquivos como script CGI, use cgi-script
se quer processar instruções SSI, use server-parsed
se quer entregar conteúdo estático, em alguns cenários pode ser usado default-handler

A escolha do handler é o ponto mais importante do processo. Um handler inadequado pode gerar resultado totalmente diferente do esperado.

Passo 4 – Informar a extensão desejada

No campo de extensão, digite a extensão que passará a usar esse handler.

Exemplos práticos:

cgiapp
plx2
shtmlx
minhaext

Se o seu objetivo for fazer um arquivo como teste.cgiapp ser executado como CGI, a extensão informada será cgiapp.

Depois da associação, qualquer arquivo com a mesma extensão poderá seguir o mesmo tratamento, desde que o restante da configuração do site e as permissões estejam corretos.

Passo 5 – Adicionar a associação

Depois de preencher o Handler e a Extension, clique em Add ou no botão equivalente da interface.

Tradução útil:

Add = Adicionar

Ao concluir, a regra passa a aparecer na lista de handlers definidos pelo usuário, quando a interface exibe essa tabela.

Esse é o momento em que o cPanel grava a associação para que o Apache trate aquela extensão conforme o handler escolhido.

Passo 6 – Testar o comportamento na prática

Depois de criar o handler, teste um arquivo real no navegador.

Exemplo:

crie ou envie um arquivo com a extensão configurada
acesse a URL correspondente
verifique se o comportamento foi o esperado

Se a intenção era executar um CGI, o arquivo deverá ser processado como script.

Se a intenção era processar SSI, o conteúdo deverá refletir as diretivas suportadas.

Não basta cadastrar a regra e assumir que funcionou. O teste prático é essencial, porque o resultado também depende do ambiente, permissões, conteúdo do arquivo e recursos habilitados no servidor.

Exemplo prático de criação

Imagine que você tenha um sistema legado que usa arquivos com extensão .cgiapp, mas quer que o Apache trate esses arquivos como CGI.

Nesse caso, você pode preencher:

Handler: cgi-script
Extension: cgiapp

Depois disso, arquivos como relatorio.cgiapp poderão ser tratados como CGI, se o restante da configuração estiver compatível.

Esse tipo de ajuste é comum quando um site antigo foi migrado e continua usando extensões personalizadas.

Cuidados importantes

não associe extensões comuns sem necessidade
não use handlers sem saber exatamente o efeito desejado
tenha atenção com arquivos executáveis
revise permissões e estrutura do arquivo se o resultado não funcionar
teste em um arquivo de exemplo antes de aplicar em larga escala

Uma configuração errada pode causar erro 500, exibição incorreta, download indevido do arquivo ou processamento inesperado pelo servidor.

Resultado esperado

Ao final do processo, você terá:

um handler associado a uma extensão específica
um novo comportamento para arquivos com essa extensão
possibilidade de testar aplicações legadas ou fluxos personalizados

Se tudo estiver correto, o Apache passará a tratar aquela extensão conforme o handler escolhido.

Resumo

Para criar um Apache Handler no cPanel:

1. acesse o cPanel
2. abra Apache Handlers
3. informe o handler
4. informe a extensão
5. adicione a regra
6. teste um arquivo real com essa extensão

Na prática, esse recurso serve para mudar o tratamento que o Apache dará aos arquivos de determinada extensão.

Se você não tiver certeza sobre qual handler usar para a sua aplicação, solicite orientação antes de salvar a configuração.

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

0 Usuários acharam útil