Cache Purge#

Permite limpiar el contenido de la caché.

Instalación#

Para instalar el módulo, use uno de los siguientes paquetes:

Angie: angie-module-cache-purge
Angie PRO: angie-pro-module-cache-purge

Carga del Módulo#

Cargue el módulo en el contexto main{}:

load_module modules/ngx_http_cache_purge_module.so;

Ejemplo de Configuración#

log_format test_cache '[$time_local] "$request" '
                      '$status $body_bytes_sent rt="$request_time" '
                      'ucs="$upstream_cache_status" us="$upstream_status" '
                      'ubr=$upstream_bytes_received';

proxy_cache_path /var/cache/angie/cache keys_zone=cache_zone:10m;

server {
    listen 80 default_server;

    location / {
        access_log /var/log/angie/cache-access.log test_cache;
        proxy_pass http://127.0.0.1:8080;

        proxy_cache cache_zone;
        proxy_cache_valid 10m;
        proxy_cache_key $uri$is_args$args;
        proxy_cache_purge PURGE from 127.0.0.1;
    }
}

Preparación para la Demostración#

Solicite un archivo del servidor:

$ curl -s -o testf1.txt http://127.0.0.1/storage/testf1.txt

Verifique la caché (MISS — archivo no encontrado en caché):

[05/Mar/2025:17:44:24 +0300] "GET /storage/testf1.txt HTTP/1.1" 200 519 rt="0.001" ucs="MISS" us="200" ubr=752

Solicite nuevamente (HIT — archivo servido desde caché):

$ curl -s -o testf1.txt http://127.0.0.1/storage/testf1.txt

[05/Mar/2025:17:46:02 +0300] "GET /storage/testf1.txt HTTP/1.1" 200 519 rt="0.000" ucs="HIT" us="-" ubr=-

Limpieza de la Caché#

$ curl -X PURGE http://127.0.0.1/storage/*

<html><head><title>Successful purge</title></head><body bgcolor="white"><center><h1>Successful purge</h1><p>Key : /storage/*</p></center></body></html>

Solicite un archivo después de la limpieza de caché (MISS — archivo cargado nuevamente):

$ curl -s -o testf1.txt http://127.0.0.1/storage/testf1.txt

[05/Mar/2025:17:52:05 +0300] "GET /storage/testf1.txt HTTP/1.1" 200 519 rt="0.002" ucs="MISS" us="200" ubr=752

Ejemplo de Configuración para una Ubicación Separada de Limpieza de Caché#

proxy_cache_path /var/cache/angie/cache keys_zone=cache_zone:10m;

map $uri $wpurgeuri {
    "~/purge(?<wpurge>/.*)" $wpurge;
    default $uri;
}

server {
    listen 80 default_server;

    location / {
        access_log /var/log/angie/cache-access.log test_cache;
        proxy_pass http://127.0.0.1:8080;

        proxy_cache cache_zone;
        proxy_cache_valid 10m;
        proxy_cache_key $uri$is_args$args;
    }

    location /purge {
        allow 127.0.0.1;
        deny all;
        proxy_cache_purge cache_zone $wpurgeuri$is_args$args;
    }
}

Solicitud para limpiar la caché en este caso:

$ curl -X PURGE http://127.0.0.1/purge/storage/*

Información Adicional#

La documentación completa de las directivas y el código fuente están disponibles en: nginx-modules/ngx_cache_purge