<!-- review: finished -->

<a id="external-redis2"></a>

# Redis2

El módulo `redis2` proporciona la capacidad de interactuar con un servidor
Redis 2.x. Implementa el protocolo Redis 2.0 unificado completo, incluyendo soporte
para pipelining de Redis.

<a id="installation-23"></a>

## Instalación

Para [instalar](https://es.angie.software//angie/docs/installation/index.md#install-packages) el módulo, use uno de los siguientes paquetes:

- Angie: `angie-module-redis2`
- Angie PRO: `angie-pro-module-redis2`

<a id="loading-the-module-23"></a>

## Carga del módulo

Para trabajar con el módulo, debe cargarse en el contexto `main{}`.
El ejemplo a continuación también usa directivas del módulo [set-misc](https://es.angie.software//angie/docs/installation/external-modules/set-misc.md#external-set-misc):

```nginx
load_module modules/ndk_http_module.so;
load_module modules/ngx_http_set_misc_module.so;
load_module modules/ngx_http_redis2_module.so;
```

<a id="configuration-example-97"></a>

## Ejemplo de configuración

```nginx
upstream redis_upstream {
    server 127.0.0.1:6379;
}

server {
    listen       80;
    server_name  localhost;

    # Establecer un valor de clave
    location /foo {
        set $value 'first';
        redis2_query set one $value;
        redis2_pass redis_upstream;
    }

    # Obtener un valor por clave
    location /bar {
        redis2_query get one;
        redis2_pass redis_upstream;
    }

    # Establecer un valor de clave desde parámetros de consulta
    location /set {
        set_unescape_uri $key $arg_key;
        set_unescape_uri $val $arg_val;
        redis2_query set $key $val;
        redis2_pass 127.0.0.1:6379;
    }

    # Obtener un valor por clave desde parámetros de consulta
    location /get {
        set_unescape_uri $key $arg_key;
        redis2_query get $key;
        redis2_pass 127.0.0.1:6379;
    }

    # Ejecutar múltiples comandos en pipeline
    location /pipeline {
        set $value 'first';
        redis2_query set one $value;
        redis2_query get one;
        redis2_query set one 'first first';
        redis2_query get one;
        redis2_pass 127.0.0.1:6379;
    }

    # Ejecutar un comando arbitrario pasado en un parámetro de consulta
    location /cmd {
        set_unescape_uri $cmd $arg_command;
        redis2_raw_query "$cmd\r\n";
        redis2_pass 127.0.0.1:6379;
    }
}
```

#### WARNING
¡Importante! A diferencia de la directiva `proxy_pass` en Angie, no está permitido usar variables en el parámetro de la directiva `redis2_pass`.

<a id="request-execution-demonstration"></a>

## Demostración de ejecución de solicitudes

Ejemplos de trabajo con el módulo.

```console
$ curl localhost/foo
+OK

$ curl localhost/bar
$5
first
```

Aquí `$5` es la longitud del valor (5 bytes), y `first` es el valor en sí.

```console
$ curl 'localhost/set/?key=two&val=second%20value'
+OK

$ curl 'localhost/get/?key=two'
$12
second value

$ curl 'localhost/get/?key=three'
$-1
```

El valor `$-1` indica que la clave `three` no existe.

```console
$ curl localhost/pipeline
+OK
$5
first
+OK
$11
first first
```

Ejecutando comandos Redis arbitrarios:

```console
$ curl 'localhost/cmd/?command=set%20three%20"third%20value"'
+OK

$ curl 'localhost/cmd/?command=get%20three'
$11
third value
```

<a id="additional-information-24"></a>

## Información adicional

La documentación detallada y el código fuente están disponibles en:
[https://github.com/openresty/redis2-nginx-module](https://github.com/openresty/redis2-nginx-module).