image_filter

Директива image_filter в NGINX позволяет манипулировать и фильтровать файлы изображений на лету. — NGINX HTTP Core

image_filter
location
Синтаксисimage_filter filter_type [filter_options];
По умолчаниюnone
Контекстlocation
МодульNGINX HTTP Core
Аргументы1-3

Описание

Директива `image_filter` является частью модуля фильтрации изображений NGINX, который предоставляет возможности обработки файлов изображений с помощью заданных фильтров. Эту директиву можно использовать внутри блока `location`, чтобы включить операции, такие как изменение размера, обрезка и изменение формата изображений, отдаваемых веб‑сервером. Директива принимает от одного до трёх аргументов: тип фильтра, его параметры и необязательные флаги конфигурации. Фильтры могут включать такие опции, как изменение размера изображения до заданных размеров или изменение формата для оптимизации времени загрузки и уменьшения использования ресурсов. В зависимости от указанных фильтров и их конфигурации NGINX обрабатывает файлы изображений динамически при запросе, вместо выдачи статических копий, что может значительно улучшить производительность и гибкость.

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

location /images {
    image_filter resize 800 600;
    image_filter_jpeg_quality 85;
    image_filter_cache on;
}

Убедитесь, что модуль image_filter включён в сборку NGINX; в противном случае директива не будет работать.

Параметры фильтра могут различаться в зависимости от указанного типа фильтра; обратитесь к документации за допустимыми параметрами.

Будьте осторожны с настройками кэширования; неправильное управление кэшем может привести к выдаче устаревших изображений.