scgi_cache_purge

Директива `scgi_cache_purge` позволяет удалять кэшированное содержимое из SCGI-кэша на основе указанного ключа кэша.

Синтаксисscgi_cache_purge zone_name key;
По умолчаниюnone
Контекстhttp, server, location
Аргументы1+

Описание

Директива scgi_cache_purge является частью модуля NGINX Cache Purge, который позволяет очищать кэшированное содержимое из SCGI-кэшей. Эта директива может быть настроена в контекстах http, server или location и требует одного или нескольких аргументов, указывающих зону кэша и ключ кэша для очистки. Основное назначение директивы — поддерживать гигиену кэша, удаляя устаревшие или неактуальные записи и обеспечивая пользователям получение актуального содержимого.

При использовании scgi_cache_purge можно указать способ взаимодействия с системой кэширования и задавать условия на основе IP-адреса клиента, отправляющего запрос на очистку. Например, администраторы могут настроить директиву так, чтобы разрешать очистку только с определённых IP-адресов или сетей, повышая безопасность и предотвращая несанкционированную очистку кэша. Директива интегрируется с общей системой кэширования в NGINX, что гарантирует, что при получении запроса на очистку содержимое, связанное с указанным ключом, будет эффективно помечено как недействительное и удалено из кэша.

Директива также поддерживает возврат с различными типами содержимого (HTML, JSON, XML или plain text) после завершения операции очистки, что облегчает её интеграцию в API-процессы или веб-приложения, которым может потребоваться подтверждение выполненной операции.

Пример конфига

location /purge {
    scgi_cache_purge my_cache_zone $uri;
    allow 192.168.1.0/24;  # Allow purging from this IP range.
    deny all;  # Deny all other requests.
}

Обеспечьте корректную фильтрацию IP-адресов, чтобы избежать несанкционированных очисток.

Помните, что ключ должен совпадать с ключом кэша, используемым при сохранении содержимого; в противном случае очистка не окажет никакого эффекта.

Директива scgi_cache_purge требует правильной настройки для корректной работы; неправильная конфигурация может привести к тому, что кэш не будет очищаться, как ожидалось.

← Ко всем директивам