empty_gif

Директива 'empty_gif' настраивает NGINX на выдачу пустого GIF-изображения. — NGINX HTTP Core

empty_gif
location
Синтаксисempty_gif;
По умолчаниюnone
Контекстlocation
МодульNGINX HTTP Core
Аргументыnone

Описание

Директива 'empty_gif' используется внутри контекста location в конфигурации NGINX, чтобы инструктировать сервер возвращать небольшой прозрачный GIF, когда запрос соответствует этому location. Эта директива особенно полезна для пикселей отслеживания или заполнителей, где контент недоступен, но требуется ответ для клиентского отслеживания. Директива не принимает аргументов и активирует встроенный URL-ответ для пустого GIF-изображения, которое имеет размер 1x1 пиксель и полностью прозрачно. Когда поступает запрос к location, в котором задана директива 'empty_gif', NGINX не будет обрабатывать дальнейшие директивы для этого запроса в этом location; вместо этого он сформирует HTTP-ответ, содержащий данные GIF-изображения. По умолчанию NGINX выполняет типичную обработку запроса, если иное не указано директивами, подобными 'empty_gif'. Поэтому эффективное использование этой директивы требует аккуратного размещения в определениях location в конфигурации сервера, чтобы она случайно не перекрывала другие настройки конфигурации. Директива расширяет возможности сервера по предоставлению ряда функций без необходимости наличия физического файла изображения на сервере, что оптимизирует использование ресурсов и упрощает конфигурацию в сценариях, таких как аналитическое отслеживание или отображение визуальных заполнителей.

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

location /tracking {
    empty_gif;
}

Убедитесь, что директива находится в правильном контексте location; в противном случае она не будет работать как задумано.

Использование 'empty_gif' в контексте location вместе с другими конфликтующими директивами может привести к непредсказуемому поведению; тщательно протестируйте конфигурацию.