upload_progress_header
Директива upload_progress_header задаёт имя HTTP-заголовка, используемого для отчёта о прогрессе загрузки.
Описание
Директива upload_progress_header предназначена для указания имени HTTP-заголовка, который будет использоваться для передачи клиентам информации о прогрессе загрузки файлов. Этот заголовок важен, потому что он позволяет скриптам на стороне клиента отслеживать прогресс операции загрузки в реальном времени. Модуль фиксирует прогресс загрузок с помощью уникальных идентификаторов и использует указанный заголовок для передачи клиенту обновлений о текущем состоянии загрузки, например о том, сколько уже отправлено и сколько осталось.
Директива может размещаться в контекстах 'http', 'server' или 'location', что означает, что она может применяться ко всему блоку 'server', к отдельным серверам или к отдельным 'location', обеспечивая гибкую конфигурацию, адаптируемую под потребности различных маршрутов и ресурсов. Ожидаемое значение — строка, представляющая имя заголовка. Например, распространённым вариантом является 'X-Upload-Progress', что позволяет JavaScript на стороне клиента отслеживать этот заголовок и обновлять интерфейс пользователя соответствующим образом.
При настройке этой директивы следует учитывать, что указанное имя заголовка не должно конфликтовать с существующими заголовками, используемыми приложением, или с заголовками, которые могут требоваться другими модулями или конфигурациями. Кроме того, убедитесь, что заголовок корректно обрабатывается в логике приложения, управляющей загрузками, чтобы он мог эффективно передавать клиенту состояние загрузки.
Пример конфига
server {
location /upload {
upload_progress_header X-Upload-Progress;
...
}
}Убедитесь, что указанное имя заголовка не конфликтует с существующими HTTP-заголовками.
Отслеживание прогресса будет работать только если загрузки правильно настроены и отслеживаются с помощью директивы upload_progress.
Если клиент некорректно обрабатывает указанный заголовок, это может привести к путанице относительно состояния загрузки.