# Keyval
O módulo permite o uso de variáveis com valores de pares "chave-valor",
que são armazenados em memória compartilhada ou em um armazenamento Redis.
## 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-keyval`
- Angie PRO: `angie-pro-module-keyval`
## Carregando o Módulo
Para trabalhar com o módulo, ele deve ser carregado no contexto `main{}`:
```nginx
load_module modules/ngx_http_keyval_module.so;
```
## Exemplo de Configuração
```nginx
keyval_zone zone=one:32k;
keyval $arg_key $value zone=one;
server {
listen 80;
server_name localhost;
location /get {
return 200 "key '$arg_key' has value = '$value'\\n";
}
location /set {
set $value $arg_value;
return 200 "'$arg_key' key added with '$arg_value' value\\n";
}
}
```
A adição e modificação de entradas na zona de memória compartilhada 'one' é feita
atribuindo um valor à variável `$value`. O valor da chave
é armazenado na variável `$arg_key`. Nesta configuração, isso é feito através da
diretiva `set`:
```nginx
set $value $arg_value;
```
## Demonstração
Vamos definir alguns valores usando requisições:
```console
$ curl "localhost/set/?key=one&value=TextForKeyOne"
'one' key added with 'TextForKeyOne' value
```
```console
$ curl "localhost/set/?key=two&value=TextForKeyTwo"
'two' key added with 'TextForKeyTwo' value
```
Vamos verificar:
```console
$ curl "localhost/get/?key=one"
key 'one' has value = 'TextForKeyOne'
```
```console
$ curl "localhost/get/?key=two"
key 'two' has value = 'TextForKeyTwo'
```
## Usando Redis
Vamos modificar a configuração para armazenar pares "chave-valor" em um armazenamento Redis:
```nginx
keyval_zone_redis zone=oneredis;
keyval $arg_key $value zone=oneredis;
server {
listen 80;
server_name localhost;
location /get {
return 200 "key '$arg_key' has value = '$value'\\n";
}
location /set {
set $value $arg_value;
return 200 "'$arg_key' key added with '$arg_value' value\\n";
}
}
```
Vamos adicionar um par "chave-valor" ao armazenamento Redis via requisição:
```console
$ curl "localhost/set/?key=one&value=TextForKeyOne"
'one' key added with 'TextForKeyOne' value
```
O mesmo pode ser feito usando o próprio Redis:
```console
$ redis-cli
127.0.0.1:6379> set oneredis:two 'text for key two'
OK
127.0.0.1:6379>
```
Vamos verificar:
```console
$ redis-cli --scan
"oneredis:one"
"oneredis:two"
```
```console
$ curl "localhost/get/?key=one"
key 'one' has value = 'TextForKeyOne'
```
```console
$ curl "localhost/get/?key=two"
key 'two' has value = 'text for key two'
```
## Informações Adicionais
Uma descrição completa das diretivas e o código-fonte estão disponíveis em:
[https://github.com/kjdev/nginx-keyval](https://github.com/kjdev/nginx-keyval).