<!-- review: finished -->

<a id="external-enhanced-memcached"></a>

# Enhanced Memcached

Модуль расширяет возможности встроенного модуля [Memcached](https://angie.software//angie/docs/configuration/modules/http/http_memcached.md#http-memcached),
позволяя добавлять и удалять данные "ключ-значение" на сервере memcached.

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

## Установка

Для [установки](https://angie.software//angie/docs/installation/index.md#install-packages) модуля используйте один из
следующих пакетов:

- Angie: `angie-module-enhanced-memcached`;
- Angie PRO: `angie-pro-module-enhanced-memcached`.

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

## Загрузка модуля

Подключение модуля в контексте `main{}`:

```nginx
load_module modules/ngx_http_enhanced_memcached_module.so;
```

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

## Пример конфигурации

```nginx
upstream memcached_upstream {
    server 127.0.0.1:11211;
}

server {
    listen 80;
    server_name localhost;

    location / {
        set $enhanced_memcached_key "$request_uri";
        enhanced_memcached_allow_put on;
        enhanced_memcached_allow_delete on;
        enhanced_memcached_pass memcached_upstream;
    }

    location /stats {
        enhanced_memcached_stats on;
        enhanced_memcached_pass memcached_upstream;
        access_log off;
    }

    location /flush {
        enhanced_memcached_flush on;
        enhanced_memcached_pass memcached_upstream;
    }
}
```

<a id="request-examples"></a>

## Примеры выполнения запросов

Добавление ключа `key1` со значением `key1 value`:

```console
$ curl -X PUT -d 'key1 value' http://127.0.0.1/key1
STORED
```

Получение значения `key1`:

```console
$ curl http://127.0.0.1/key1
key1 value
```

Удаление данных с ключом `key1`:

```console
$ curl -X DELETE http://127.0.0.1/key1
DELETED
```

Вывод статистики memcached:

```console
$ curl http://127.0.0.1/stats
```

Очистка всех данных:

```console
$ curl http://127.0.0.1/flush
```

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

## Дополнительная информация

Подробная документация и исходный код доступны по ссылке:
[https://github.com/bpaquet/ngx_http_enhanced_memcached_module](https://github.com/bpaquet/ngx_http_enhanced_memcached_module)