html_sanitize_hash_max_size

Определяет максимальный размер хеш-таблицы, используемой для хранения санитизированных элементов HTML.

Синтаксисhtml_sanitize_hash_max_size size;
По умолчаниюnone
Контекстlocation
Аргументыflag

Описание

Директива html_sanitize_hash_max_size настраивает максимальный размер хеш-таблицы, используемой модулем санитизации HTML в NGINX. Эта директива особенно полезна для контроля потребления памяти при обработке очистки HTML-контента. Установив эту директиву, пользователи могут ограничить количество уникальных элементов и атрибутов, которые могут храниться в хеш-таблице во время санитизации, тем самым оптимизируя использование ресурсов.

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

По сути, эта директива играет критическую роль в балансировании производительности и управления ресурсами во время фазы обработки запроса, особенно при работе с потенциально большими или сложными структурами HTML-контента.

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

location /sanitize {
    html_sanitize on;
    html_sanitize_hash_max_size 1024;
}

Установка этого значения слишком низким может привести к увеличению времени обработки, поскольку хэшированные записи пересчитываются.

Если вы установите html_sanitize_hash_max_size в очень большое значение без достаточных ресурсов, это может привести к увеличению использования памяти.

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