Base de Conhecimento

6.09 Como usar o handler cgi-script

O handler cgi-script faz o Apache tratar um arquivo como script CGI, permitindo que determinada extensão seja executada como CGI em vez de ser entregue apenas como arquivo comum.

Na prática, ele é o handler mais importante dessa ferramenta para compatibilidade com aplicações antigas, scripts legados e extensões personalizadas que precisam de execução no servidor.

Como acessar o cPanel

Antes de configurar o handler, 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 rápido ao cPanel

O login normalmente exige o usuário e senha da hospedagem.

Como usar o handler cgi-script

O que esse handler faz

O cgi-script instrui o Apache a executar o arquivo como CGI.

Isso é diferente de simplesmente servir um arquivo estático. Em vez de apenas entregar o conteúdo, o servidor passa a tratar aquele arquivo como programa ou script CGI.

Esse comportamento é útil principalmente em sistemas legados e integrações antigas que ainda dependem de CGI.

Quando usar

Use esse handler quando:

você tiver scripts CGI com extensão personalizada
precisar preservar a estrutura de uma aplicação antiga
quiser que determinada extensão seja executada como script

Exemplos de extensões personalizadas que poderiam ser associadas:

cgiapp
scriptcgi
legacyrun

O uso correto do cgi-script evita renomear todos os arquivos para .cgi ou formatos tradicionais semelhantes.

Passo 1 – Abrir Apache Handlers

No cPanel, entre em Avançado e clique em Apache Handlers.

Passo 2 – Preencher o handler

No campo Handler, digite:

cgi-script

Tradução útil:

cgi-script = tratar como script CGI

Passo 3 – Informar a extensão desejada

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

Exemplo:

cgiapp

Depois disso, arquivos como consulta.cgiapp poderão ser tratados como CGI.

A associação vale para os arquivos que usam a extensão configurada, desde que a aplicação e o ambiente estejam corretos.

Passo 4 – Salvar a configuração

Clique em Add para registrar a associação.

Depois, localize um arquivo real com essa extensão e teste a URL correspondente.

Como testar corretamente

envie um arquivo de exemplo com a extensão cadastrada
acesse a URL completa no navegador
veja se o comportamento é de execução e não apenas de exibição
se houver erro, revise o script e consulte os logs do site

Não confunda “criar a associação” com “garantir o funcionamento do script”. O arquivo em si também precisa estar correto para rodar.

Exemplos de uso no dia a dia

migração de um sistema antigo que usava extensão própria
adaptação de um aplicativo legado que não foi renomeado
preservação da estrutura original de scripts sem alterar centenas de arquivos

Esse é um dos usos mais práticos da ferramenta Apache Handlers para quem trabalha com compatibilidade e migração de sites antigos.

Cuidados importantes

use uma extensão reservada apenas para scripts confiáveis
não associe extensões já usadas por conteúdo comum do site
evite aplicar em massa sem testar antes
revise permissões e formato do script se houver erro

Um erro nesse tipo de associação pode causar falhas de execução, exposição indevida do conteúdo do script ou erro interno do servidor.

Resultado esperado

Ao final, arquivos com a extensão configurada serão tratados como CGI pelo Apache, desde que o ambiente esteja apto para isso.

Isso permite compatibilidade com aplicações legadas e extensões personalizadas sem reestruturação completa do projeto.

Resumo

O handler cgi-script serve para fazer o Apache executar arquivos de determinada extensão como scripts CGI.

Passos básicos:
1. abrir Apache Handlers
2. informar cgi-script
3. informar a extensão desejada
4. adicionar a regra
5. testar um arquivo real

É o handler mais útil para compatibilidade com scripts legados que usam extensões personalizadas.

Se o script não rodar corretamente, o ideal é revisar também permissões, estrutura do arquivo e logs de erro do servidor.

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

0 Usuários acharam útil