# CGI
O módulo adiciona suporte para CGI.
É importante observar que CGI **não é** adequado para:
- alto QPS;
- tráfego pesado;
- alta concorrência.
## Instalação
Para [instalar](https://pt.angie.software//angie/docs/installation/index.md#install-packages) o módulo, use um dos
seguintes pacotes:
- Angie: `angie-module-cgi`
- Angie PRO: `angie-pro-module-cgi`
## Carregando o Módulo
Para carregar o módulo no contexto de `main{}`:
```nginx
load_module modules/ngx_http_cgi_module.so;
```
## Exemplo de Configuração
```nginx
server {
listen 80;
root /usr/share/angie/html;
index index.html index.htm;
location /cgi {
alias /usr/share/angie/cgi-bin;
cgi on;
}
}
```
## Script de Teste
Um exemplo de script executável de teste `test.sh`:
```bash
#!/bin/sh
echo "Content-Type: text/plain" # Adiciona cabeçalho à resposta
echo "" # Separador entre cabeçalhos e corpo da resposta
# Variáveis de ambiente
echo "query string: $QUERY_STRING"
echo "server addr: $SERVER_ADDR"
echo "server port: $SERVER_PORT"
# Cabeçalhos da requisição via variáveis de ambiente
echo "http host: $HTTP_HOST"
echo "http accept: $HTTP_ACCEPT"
echo "http Some-Field: $HTTP_SOME_FIELD"
body=$(cat) # Lê o corpo da requisição em uma variável
echo "Request body: $body"
```
## Colocando o Script
De acordo com a configuração, o script deve ser colocado no diretório
`/usr/share/angie/cgi-bin/`.
O arquivo deve ter permissões de leitura e execução.
## Exemplo de Execução de Requisição
```console
$ curl -H 'Some-Field:some text' -d '{"key1":"value1", "key2":"value2"}' -i \
'http://127.0.0.1/cgi/hello.sh?a=valueA&b=valueB'
HTTP/1.1 200 OK
Server: Angie/|angie_version|
Date: |sampledatelong| 19:15:35 GMT
Transfer-Encoding: chunked
Connection: keep-alive
Content-Type: text/plain
query string: a=valueA&b=valueB
server addr: 127.0.0.1
server port: 80
http host: 127.0.0.1
http accept: */*
http Some-Field: some text
Request body: {"key1":"value1", "key2":"value2"}
```
## Informações Adicionais
Documentação detalhada e código-fonte estão disponíveis em:
[https://github.com/pjincz/nginx-cgi](https://github.com/pjincz/nginx-cgi)