image_filter_webp_quality

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

Синтаксисimage_filter_webp_quality quality;
По умолчанию75
Контекстhttp, server, location
Аргументы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) приведёт к увеличению размера файлов, что может повлиять на скорость загрузки.

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