upload_tame_arrays

Директива `upload_tame_arrays` управляет тем, преобразуются ли массивы загруженных файлов в строковые значения в NGINX.

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

Описание

Директива upload_tame_arrays в модуле загрузки NGINX позволяет настроить обработку массивов загруженных файлов. При значении 'on' эта директива изменяет поведение загрузки файлов так, что если под одним и тем же именем поля загружено несколько файлов, они будут объединены в одно строковое значение с подходящим разделителем. Это может быть полезно для упрощения доступа к загруженным данным в некоторых сценариях приложений, где структура массива не требуется. Напротив, при значении 'off' модуль сохраняет стандартную структуру массивов файлов, что может привести к более сложной обработке загруженных файлов, но сохраняет их исходную форму с возможностью отдельного доступа к каждому файлу.

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

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

server {
    location /upload {
        upload_pass /upload/process;
        upload_tame_arrays on;
        upload_store /tmp/uploads;
    }
}

Изменение директивы с 'off' на 'on' может нарушить работу бэкенд-приложений, ожидающих структуры массива.

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

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