concat_delimiter

Директива `concat_delimiter` задаёт строку, которая разделяет объединённые файлы в HTTP-ответах.

Синтаксисconcat_delimiter delimiter_string;
По умолчаниюnone
Контекстhttp, server, location
Аргументы1

Описание

Директива concat_delimiter является частью модуля HTTP Concatenation для NGINX и позволяет задавать разделители между объединяемыми файлами в ответе. Эта директива принимает один строковый аргумент, который служит разделителем, когда несколько ресурсов, таких как JavaScript или CSS, объединяются в единый HTTP-ответ. Использование этой директивы помогает более структурировать вывод, что особенно полезно, когда клиенты ожидают определённого форматирования для корректного разбора объединённого содержимого.

Директиву concat_delimiter можно применять в контекстах http, server или location, что даёт гибкость в конфигурации. Когда директива установлена, при каждом объединении файлов в ходе запроса между соответствующими содержимыми файлов будет вставляться указанный разделитель. Например, если ваш разделитель установлен на точку с запятой, в ответе будут содержаться точки с запятой, разделяющие объединённые файлы вместо поведения по умолчанию, когда файлы просто склеиваются без разделителей. Это особенно полезно при отладке или при обработке MIME-типов, которые могут требовать специфических разделителей для корректного парсинга на стороне клиента.

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

location /static/js/ {
    concat on;
    concat_delimiter ';';
}

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

Разделитель следует тщательно выбирать с учётом типов файлов, чтобы не нарушить функциональность, особенно в случае файлов JavaScript и CSS.

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