upload_store

Директива `upload_store` указывает каталог, в котором будут временно храниться загруженные файлы.

Синтаксисupload_store [options];
По умолчаниюnone
Контекстhttp, server, location, if in location, limit_except
Аргументы1-4

Описание

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

После того как файлы сохранены в указанном каталоге, их можно обрабатывать напрямую — например, продолжать обработку или отдавать клиентам. Если каталог не имеет необходимых прав на запись, загрузка файлов будет невозможна. Важно убедиться, что NGINX имеет соответствующие права доступа к каталогу загрузки; хорошей практикой является регулярная очистка этого каталога, чтобы он со временем не заполнился. Директива upload_store работает совместно с другими директивами, например upload_pass, которая определяет, куда направлять запрос после завершения загрузки, и upload_cleanup, которая задаёт порядок управления временными файлами после обработки.

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

location /upload {
    upload_store /tmp/uploads;
    upload_pass /handle_upload;
}

Убедитесь, что указанный каталог существует и имеет соответствующие права на запись; в противном случае загрузки не будут выполнены.

Файлы, хранящиеся в каталоге загрузки, не будут автоматически удаляться, если не настроен upload_cleanup.

Проверьте настройки безопасности, чтобы не подвергать каталог загрузки неавторизованному доступу.

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