concat_ignore_file_error

Директива `concat_ignore_file_error` указывает NGINX продолжать обработку запросов, несмотря на ошибки «файл не найден» в списках объединённых файлов.

Синтаксисconcat_ignore_file_error on | off;
По умолчаниюoff
Контекстhttp, server, location
Аргументыflag

Описание

Директива concat_ignore_file_error является частью модуля HTTP Concatenation для NGINX, который позволяет объединять несколько файлов, таких как CSS и JavaScript, и обслуживать их в одном запросе для оптимизации. Когда эта директива включена, если какой-либо из указанных файлов в объединённом запросе отсутствует (что приводит к ошибкам «файл не найден»), NGINX проигнорирует такие ошибки и продолжит обработку оставшихся файлов вместо того, чтобы завершать запрос с ошибкой. Такое поведение может быть особенно полезно в средах разработки или в сценариях, где некоторые файлы могут быть временно недоступны, поскольку оно позволяет частично обслуживать ресурсы вместо полного сбоя.

Параметр этой директивы — бинарный флаг: значение on включает функцию, а значение off отключает её. Установка директивы в on позволяет разработчикам тестировать свои приложения без необходимости обеспечивать доступность каждого файла постоянно, тем самым предоставляя гибкость в циклах разработки. Однако использование в продуктивных окружениях следует рассматривать с осторожностью, так как это может привести к тому, что клиентам будут отправляться неполные ресурсы без явного указания об ошибке.

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

location /static/files/ {
    concat on;
    concat_ignore_file_error on;
}

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

Чрезмерная зависимость от этой директивы может скрывать реальные проблемы, когда файлы отсутствуют или неправильно настроены.

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