open_file_cache_valid

Директива open_file_cache_valid задаёт, как долго информация о кэшированных файлах считается действительной. — NGINX HTTP Core

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

Описание

Директива `open_file_cache_valid` используется для настройки срока действия кэшированных атрибутов файлов в NGINX. Она принимает один аргумент, который указывает длительность, в течение которой информация о кэшированных файлах считается действительной, прежде чем NGINX попытается проверить файловую систему на наличие обновлений. Эта функциональность особенно полезна для оптимизации производительности доступа к файлам за счёт сокращения ненужных проверок файловой системы и, как следствие, улучшения времени отклика при обслуживании статических файлов. Вы можете устанавливать эту директиву в контекстах `http`, `server` или `location`, что даёт гибкость в зависимости от конфигурации сервера. Аргумент — это значение времени (например, `30s`, `5m`, `1h`), указывающее длительность, в течение которой статус файла (например, время модификации) должен считаться действительным. NGINX будет обходить проверки файловой системы для файлов, которые всё ещё находятся в пределах этого периода действия, полагаясь на кэшированную информацию при обслуживании запросов. После истечения указанного периода NGINX повторно проверит кэшированную информацию, обеспечивая распознавание изменений файлов в файловой системе. Важно тщательно выбирать длительность действия, чтобы найти баланс между производительностью (сокращением проверок файловой системы) и точностью (актуальной информацией с диска).

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

open_file_cache active; 
open_file_cache_valid 30s;

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

Убедитесь, что файловый кэш включён с помощью 'open_file_cache', чтобы 'open_file_cache_valid' вступил в силу.