upload_aggregate_form_field

Директива upload_aggregate_form_field является частью модуля загрузки NGINX, который предоставляет возможности для обработки загрузок файлов с использованием кодировки multipart/form-data. Эта директива специально позволяет агрегировать загруженные файлы в одно поле формы, позволяя рассматривать несколько файлов как единое целое в запросе. Это полезно в сценариях, где приложению нужно обрабатывать несколько файлов вместе, например когда пользователь отправляет несколько изображений, которые должны быть сохранены в одном массивном поле или обработаны как коллекция.

Данная директива принимает два параметра: имя поля формы, в которое нужно агрегировать файлы, и флаг, указывающий, включать ли исходные имена файлов при обработке агрегированных файлов. При включённой опции NGINX создаст одну запись поля формы, содержащую объединённые данные всех загруженных файлов, к которой затем бэкенд-приложение сможет получить доступ как к одному полю в разобранном теле запроса. Такое поведение агрегирования упрощает логику обработки в приложениях, которым нужно работать с пакетными загрузками, при этом соблюдается стандарт multipart/form-data.

Важно размещать эту директиву в соответствующем контексте, например внутри блоков http, server или location, чтобы она применялась к нужному месту загрузки файлов. Конфигурации с вложенными контекстами, например внутри if в location, также могут эффективно обрабатывать более сложные случаи использования, хотя следует быть осторожным, чтобы избежать осложнений, связанных с условной обработкой в NGINX.