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 acesso direto ao cPanel

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

Entendendo o objetivo da associação

Associar uma extensão a um handler significa dizer ao Apache:

“sempre que encontrar arquivos com esta extensão, trate-os usando este comportamento”.

Isso é muito útil quando:

• o site usa uma extensão personalizada
• você quer manter compatibilidade com um sistema legado
• não deseja renomear centenas de arquivos já existentes
• precisa adaptar o comportamento do servidor sem reescrever a aplicação

Passo 1 – Entrar em Apache Handlers

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

Traduções úteis:

• Advanced = Avançado
• Apache Handlers = Apache Handlers

Passo 2 – Definir qual extensão será afetada

Antes de preencher a tela, identifique claramente a extensão do arquivo que você quer associar.

Exemplos:

• .cgiapp
• .legacycgi
• .shtml2
• .incpage

Na interface, normalmente você informa apenas a parte da extensão, por exemplo:

• cgiapp
• shtml2

Passo 3 – Escolher o handler existente

Depois, escolha o handler que representará o tratamento desejado.

Alguns exemplos comuns:

• cgi-script para tratar o arquivo como script CGI
• server-parsed para processar server-side includes
• default-handler para tratamento padrão de conteúdo estático

Exemplo prático:

• extensão personalizada: cgiapp
• handler existente: cgi-script

Passo 4 – Preencher e salvar

Na tela do cPanel, informe:

• no campo Handler, o nome do handler existente
• no campo Extension(s), a extensão desejada

Depois clique em Add.

Traduções úteis:

• Handler = Handler
• Extension(s) = Extensão(ões)
• Add = Adicionar

Exemplo de associação na prática

Suponha que seu sistema antigo use arquivos com extensão .pagina, mas você quer que esses arquivos sejam processados como SSI.

Você poderia usar:

• Handler: server-parsed
• Extension: pagina

Depois disso, um arquivo como home.pagina poderá ser interpretado com o comportamento do handler escolhido.

Como validar se funcionou

Depois de criar a associação:

• envie ou localize um arquivo real com a extensão configurada
• acesse a URL correspondente
• observe se o Apache tratou o arquivo da forma desejada

Se o arquivo deveria ser executado, ele deve executar.

Se deveria ser processado com SSI, o resultado final da página deve refletir esse processamento.

Cuidados importantes

• não associe várias extensões críticas sem testes prévios
• não use handlers de execução em arquivos não confiáveis
• faça backup do conteúdo antes de grandes alterações em aplicações antigas
• teste primeiro em uma cópia ou em um arquivo de laboratório

Resultado esperado

Ao final, a extensão personalizada terá sido vinculada a um handler existente, e o Apache passará a tratá-la conforme esse comportamento.

Resumo

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