Base de Conhecimento

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 personalizada como CGI script, usando o handler cgi-script.

Na prática, isso é útil quando um sistema usa uma extensão diferente de .cgi ou .pl, mas você quer que o servidor execute esse arquivo como script CGI.

Como acessar o cPanel

Acesse o cPanel de uma destas formas:

https://seudominio.com.br/cpanel
https://seudominio.com.br:2083
pela área do cliente MyWay, usando o atalho para o cPanel

Tenha em mãos o usuário e senha da hospedagem, salvo nos casos de login automático pela área do cliente.

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

Para que isso serve

Esse ajuste serve para dizer ao Apache que arquivos com determinada extensão devem ser executados como CGI, em vez de serem entregues apenas como arquivo comum.

Isso costuma ser útil quando:

um sistema antigo usa extensões não padronizadas
você quer manter a nomenclatura original da aplicação
existem muitos arquivos e renomeá-los seria inviável

Em termos práticos, o handler cgi-script instrui o Apache a tratar o arquivo como script CGI.

Antes de começar

Antes de aplicar esse tipo de configuração, confirme alguns pontos:

o script realmente foi desenvolvido para rodar como CGI
as permissões do arquivo estão adequadas ao ambiente
o conteúdo do script está correto
o servidor permite o uso desse tipo de tratamento

Não basta apenas associar a extensão. O arquivo também precisa estar preparado para ser executado corretamente como CGI.

Passo 1 – Entrar em Apache Handlers

No cPanel, acesse a seção Avançado e clique em Apache Handlers.

Traduções úteis:

Advanced = Avançado
Apache Handlers = Apache Handlers

Passo 2 – Informar o handler CGI

No campo Handler, digite:

cgi-script

Tradução útil:

cgi-script = tratar como script CGI

Esse é o handler usado para instruir o Apache a executar o arquivo como CGI.

Passo 3 – Informar a extensão personalizada

No campo Extension(s), digite a extensão que deverá ser executada como CGI.

Exemplos:

cgiapp
meucgi
legacypl

Se você informar cgiapp, então arquivos como relatorio.cgiapp poderão ser tratados como CGI.

A lógica é simples: toda vez que o Apache encontrar aquela extensão, ele aplicará o handler cgi-script.

Passo 4 – Adicionar a regra

Depois de preencher os campos, clique em Add.

Tradução útil:

Add = Adicionar

Com isso, a associação entre a extensão e o handler CGI será cadastrada.

Passo 5 – Testar o script

Depois da configuração, acesse a URL do arquivo no navegador.

Exemplo:

https://seudominio.com.br/app/relatorio.cgiapp

Se tudo estiver correto, o arquivo deverá ser processado como script, e não exibido como texto puro.

Se o navegador baixar o arquivo, exibir o código-fonte cru ou retornar erro 500, revise a configuração, o conteúdo do script e as permissões.

Exemplo prático de uso

Imagine uma aplicação legada que usa arquivos .scriptx em vez de .cgi.

Você pode configurar:

Handler: cgi-script
Extension: scriptx

Depois disso, um arquivo como consulta.scriptx poderá receber tratamento CGI.

Esse tipo de ajuste é útil em migrações de sistemas antigos para novas hospedagens.

Cuidados de segurança

não associe extensões arbitrárias a CGI sem necessidade
garanta que apenas scripts confiáveis usem essa extensão
evite deixar arquivos executáveis expostos sem revisão
teste sempre em ambiente controlado antes de publicar em produção

Scripts CGI podem ampliar a superfície de risco se forem mal programados, antigos ou usados sem validação adequada.

Limitações comuns

Mesmo com a associação criada, o resultado pode depender de fatores como:

módulos e políticas do servidor
permissões do arquivo
estrutura correta do script
compatibilidade da aplicação com o ambiente atual

Ou seja, a associação da extensão é apenas uma parte do processo. O script em si também precisa estar apto a funcionar naquele ambiente.

Resultado esperado

Ao final, arquivos com a extensão configurada deverão ser tratados como CGI, desde que o restante da configuração também esteja correto.

Isso permite executar scripts com extensões personalizadas sem renomeá-los para as extensões tradicionais.

Resumo

Para fazer o Apache tratar uma extensão como CGI script:

1. abra Apache Handlers
2. informe cgi-script no campo handler
3. informe a extensão desejada
4. adicione a regra
5. teste um arquivo real no navegador

Esse recurso é ideal para compatibilidade com scripts CGI legados que usam extensões diferentes do padrão.

Se o script retornar erro interno, o ideal é revisar também permissões, formato do arquivo e logs de erro da hospedagem.

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

0 Usuários acharam útil