image_filter_webp_quality

Задает качество изображений WebP при фильтрации в NGINX. — NGINX HTTP Core

image_filter_webp_quality
httpserverlocation
Синтаксисimage_filter_webp_quality quality;
По умолчанию75
Контекстhttp, server, location
МодульNGINX HTTP Core
Аргументы1

Описание

`image_filter_webp_quality` директива используется для определения уровня качества изображений WebP, которые создаются при использовании модуля image_filter в NGINX. Эта директива принимает один аргумент — целое число, задающее качество (от 0 до 100) выходного изображения WebP: 100 соответствует наивысшему качеству и наименьшей компрессии, а 0 даёт наименьшее качество и максимальную компрессию. Директива должна быть включена в файлы конфигурации в контекстах `http`, `server` или `location`, так как она предназначена для управления тем, как изображения обрабатываются и отдаются. При настройке `image_filter_webp_quality` расширяет возможности NGINX по обслуживанию изображений за счёт преобразования входящих изображений в формат WebP, который часто имеет меньший размер по сравнению с другими форматами, такими как JPEG или PNG, без значительной потери визуального качества. Эта конвертация выполняется на лету, если клиент поддерживает формат WebP, что определяется по заголовку `Accept` в HTTP-запросе. Правильная установка параметра качества позволяет разработчикам балансировать между чёткостью изображений и эффективностью размера файлов в зависимости от конкретных потребностей приложения, тем самым улучшая время загрузки и производительность для страниц с большим количеством изображений.

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

location /images {
    image_filter png;
    image_filter_webp on;
    image_filter_webp_quality 85;
}

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

Использование значения вне диапазона 0-100 может привести к ошибкам или неожиданному поведению при обработке изображений.

Учтите, что установка более высокого качества (близкого к 100) приведёт к увеличению размера файлов, что может повлиять на скорость загрузки.