Spec-Zone.ru › ColdFusion

fileUploadAll

Загружает все файлы, отправленные на страницу в HTTP-запросе, в каталог на сервере.

fileUploadAll(destination [,mimeType] [,onConflict] [,strict] [,continueOnError] [,errorVariable] [,allowedExtensions]) → returns array

  • CF9.0.1+
  • Lucee
  • BL 1.0.0+
  • См. также: fileUpload

    Справочник аргументов

    destination string
    Обязательный

    Путь к каталогу, в который следует загрузить файл. Если путь не является абсолютным (начинается с буквы диска и двоеточия либо с прямой или обратной косой черты), он считается относительно временного каталога ColdFusion, возвращаемого функцией getTempDirectory. Если указанный каталог назначения не существует, ColdFusion создаёт файл с указанным именем назначения.

    mimeType string

    Ограничивает принимаемые типы MIME. Список, разделённый запятыми. Например, следующий код разрешает загрузку файлов JPEG и Microsoft Word: 'image/jpg,application/msword'. Браузер определяет тип файла по расширению имени файла.

    onConflict string
    По умолчанию: error

    Действие, которое следует выполнить, если в каталоге уже есть файл с таким же именем.
    Значения:
    • error
    • skip
    • overwrite
    • makeUnique

    strict boolean
    По умолчанию: true

    Определяет, какой метод используется для определения типа файла, который проверяется на соответствие значению параметра mimeType.true: для определения типа MIME используются первые несколько байтов загруженного файла.false: используется тип MIME, указанный браузером в теле запроса.

    continueOnError boolean
    По умолчанию: false

    CF 11+ Продолжать ли загрузку остальных файлов, если загрузка одного из файлов завершается ошибкой.

    errorVariable variableName
    По умолчанию: cffile.uploadAllErrors

    CF 11+ Имя переменной, в которой будет храниться массив структур ошибок загрузки файлов. Структура с информацией об ошибке загрузки содержит следующие поля:REASON — причина сбояDETAIL — подробности ошибки загрузки файлаMESSAGE — подробное описание ошибкиCLIENTFILE — имя файла, загруженного из системы клиентаCLIENTFILEEXT — расширение загруженного файла в системе клиента (без точки)CLIENTFILENAME — имя загруженного файла в системе клиента (без расширения)INVALID_FILE_TYPE — если MIME-тип или расширение файла отсутствует в указанном атрибуте accept. Если причина — INVALID_FILE_TYPE, в структуре будут доступны два дополнительных ключа. --ACCEPT: список MIME-типов или расширений файлов, указанных в теге--MIMETYPE: MIME-тип загруженного файлаEMPTY_FILE — если загруженный файл является пустым файломFILE_EXISTS — если файл с указанным именем уже существует в месте назначения, а политика overwritepolicy установлена в значение errorDEST — место назначения, куда копируется файлFORM_FILE_NOT_FOUND — если загруженный файл не найден на сервере

    allowedExtensions string

    CF 2018+ Список расширений файлов, разделённых запятыми, которые разрешено загружать. Например, .png, .jpg или .jpeg. Можно использовать * (звёздочку), чтобы разрешить все файлы, кроме случаев, когда тип MIME указан в атрибуте accept. Значения, заданные в атрибуте allowedExtensions, переопределяют список заблокированных расширений в настройках сервера или приложения.

    Примеры
    Пример кода, вызывающего функцию fileUploadAll

    © 2012–present Foundeo, Inc. and the CFDocs contributors.
    Licensed under the MIT License.
    ColdFusion is a trademark of Adobe Systems Incorporated.
    https://cfdocs.org/fileuploadall

    Spec-Zone.ru

    Настройки Оффлайн Что нового Помощь О нас
    Spec-Zone .ru
    спецификации, руководства, описания, API