clear_request_cookie

Директива `clear_request_cookie` удаляет указанный файл cookie из заголовков запроса в NGINX.

Синтаксисclear_request_cookie cookie_name [if=condition];
По умолчаниюnone
Контекстhttp, server, location
Аргументы1-2

Описание

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

Эта директива может использоваться в контекстах http, server или location и может принимать необязательный параметр для условного выполнения операции очистки. Это означает, что вы можете указать условие if, которое должно быть истинным, чтобы cookie было очищено, что позволяет тонко настраивать обработку запроса. Директива может принимать до двух параметров: первый — имя cookie для очистки, а необязательный второй — условие.

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

location / {
    clear_request_cookie session_id; 
    clear_request_cookie auth_token if=$http_a;
}

Неправильное использование условий может привести к неожиданному поведению, при котором cookie не будет удалено в ожидаемый момент.

Убедитесь, что имя cookie написано правильно и с учётом регистра, поскольку имена cookie считаются чувствительными к регистру.

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