Spec-Zone.ru › ColdFusion

fileUpload

Загружает файл в каталог на сервере.

fileUpload(destination [, fileField] [, mimeType] [, onConflict] [, strict]) → returns struct

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

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

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

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

    fileField string

    Имя поля формы, используемого для выбора файла. Не используйте знак номера (#) при указании имени поля.

    mimeType string

    Укажите разделенный запятыми список типов MIME и/или расширений файлов для проверки загруженного файла. Если файл не относится ни к одному из типов в этом списке, возникает ошибка типа coldfusion.tagext.io.FileUtils$InvalidUploadTypeException. Если вы указываете расширения файлов, используйте формат .txt,.jpg, а не txt, *.txt или *.*. В качестве подстановочного знака для принятия всех файлов можно использовать *.

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

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

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

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

    Примеры
    Пример кода вызова функции fileUpload

    Форма загрузки с проверкой типа MIME в строгом режиме

    <form method="post" enctype="multipart/form-data">
      <input type="file" name="fileInput">
      <button type="submit">Upload</button>
    </form>
    
    <cfscript>
      if( structKeyExists( form, "fileInput" )) {
        try {
          uploadedFile = fileUpload( getTempDirectory(), "fileInput", "image/jpeg,image/pjpeg", "MakeUnique" );
          // check the file extension of the uploaded file; mime types can be spoofed
          if (not listFindNoCase("jpg,jpeg", uploadedFile.serverFileExt)) {
          throw("The uploaded file is not of type JPG.");
          }
          // do stuff with uploadedFile...
        } catch ( coldfusion.tagext.io.FileUtils$InvalidUploadTypeException e ) {
          writeOutput( "This upload form only accepts JPEG files." );
        }
        catch (any e) {
        writeOutput( "An error occurred while uploading your file: #e.message#" );
        }
      }
    </cfscript>

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

    Spec-Zone.ru

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