upload_pass_form_field
Директива upload_pass_form_field задаёт имя поля формы в запросе, которое будет заполнено конкретным значением из загруженного файла.
Описание
Директива upload_pass_form_field является частью модуля загрузки NGINX, который облегчает загрузку файлов с использованием кодирования multipart/form-data. Эта директива указывает поле в результирующем теле запроса, которое будет получать значение, извлечённое из загруженного файла. Когда файл загружается на сервер, исходное содержимое файла удаляется из тела запроса, и вместо него могут быть созданы новые поля формы, содержащие результаты, полученные из загруженных файлов. Используя эту директиву, пользователи могут настроить данные, отправляемые в последующем запросе на прокси-сервер или в другую конечную точку обработки, что даёт больше контроля над тем, какие данные файла передаются и как они представлены.
Чтобы правильно использовать эту директиву, её следует помещать в блок location или другую соответствующую конфигурацию server/context. Требуется только один аргумент — имя поля формы, которое будет установлено в теле запроса. Директива работает в сочетании с другими в модуле загрузки NGINX, такими как upload_set_form_field, которая фактически определяет, как заполнить это поле формы значением файла. Это предоставляет гибкий механизм для обработки загрузок файлов и их сопутствующих метаданных в веб-приложениях.
Пример конфига
location /upload {
upload_pass /process_upload;
upload_store /tmp/uploads;
upload_pass_form_field myFileField;
}Убедитесь, что имя поля, указанное в upload_pass_form_field, не конфликтует с существующими именами полей в вашем приложении.
Помните, что следует использовать "upload_set_form_field", чтобы указать, как поле будет заполнено содержимым файла.
Эта директива действует только при использовании в соответствующем контексте, например location или server.