Spec-Zone.ru › ColdFusion

cffile

Управляет взаимодействием с файлами на сервере. Для разных комбинаций требуются разные атрибуты.

<cffile action="read">

fileRead(path);

  • CF2+
  • Lucee
  • BL 1.0.0+
  • См. также: fileread filewrite fileopen filereadline

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

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

    Тип операции с файлом, выполняемой тегом.
    Значения:
    • append
    • copy
    • delete
    • move
    • read
    • readbinary
    • rename
    • upload
    • uploadall
    • write

    file string

    Путь к файлу.

    mode string

    Применяется только в UNIX и Linux. Права доступа. Восьмеричные значения команды Unix chmod. Назначаются соответственно владельцу, группе и остальным пользователям.

    output string

    Строка, добавляемая в файл

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

    Yes: добавляет символ перевода строки к тексту, записываемому в файл
    Значения:
    • true
    • false

    attributes string

    Применяется в Windows. Разделённый запятыми список атрибутов, назначаемых файлу. Если атрибут не указан, текущие атрибуты файла сохраняются.
    Значения:
    • readonly
    • hidden
    • normal
    • system
    • temporary

    charset string

    Кодировка символов, в которой закодировано содержимое файла. Дополнительные сведения о кодировках символов см. на странице: www.w3.org/International/O-charset.html.
    Значения:
    • utf-8
    • iso-8859-1
    • windows-1252
    • us-ascii
    • shift_jis
    • iso-2022-jp
    • euc-jp
    • euc-kr
    • big5
    • euc-cn
    • utf-16

    source string

    Путь к файлу (при копировании).

    destination string

    Путь к каталогу или файлу на веб-сервере (при копировании).

    variable string

    Имя переменной, в которую будет помещено содержимое текстового файла.

    filefield string

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

    nameconflict string

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

    accept string

    Ограничивает список принимаемых MIME-типов. Список разделяется запятыми. Например, чтобы разрешить загрузку файлов JPG и Microsoft Word: accept = "image/jpg, application/msword"

    result variableName
    По умолчанию: cffile

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

    fixnewline string
    По умолчанию: false

    * Yes: заменяет встроенные символы окончания строки в строковых переменных на окончания строк, используемые операционной системой * No: (по умолчанию) не изменяет встроенные символы окончания строки в строковых переменных.
    Значения:
    • true
    • false

    cachedwithin numeric

    Lucee 5+ Интервал времени, заданный с помощью функции CreateTimeSpan. Если дата исходного файла попадает в этот интервал, используются кэшированные данные файла. Функция CreateTimeSpan задаёт период от текущего момента в прошлое.

    Совместимость

    BoxLang:

    Версия 1.0.0+ <bx:file> в BoxLang

    Ссылки дополнительная информация о cffile

    • Советы по безопасной загрузке файлов с помощью CFML — запись в блоге Пита Фрайтага с рекомендациями по повышению безопасности при загрузке файлов в CFML.

    Примеры
    Примеры кода с использованием тега cffile

    Синтаксис скрипта — запись

    Запись в файл

    fileWrite(expandPath("./myFile.txt"), "Here's some content for my file.");

    Синтаксис скрипта — добавление

    Добавление в файл — поскольку функции fileAppend() нет, мы открываем файл и используем fileWriteLine()

    myFile = fileOpen(expandPath("./myFile.txt"), "append"); 
     fileWriteLine(myFile, "Here's some new content."); 
     fileClose(myFile);

    Синтаксис скрипта — чтение

    Чтение файла

    myFile = fileRead(expandPath("./myFile.txt"));

    Синтаксис скрипта — чтение бинарных данных

    Чтение бинарных данных из файла

    myImageBinary = fileReadBinary(expandPath("./myImage.jpg"));

    Синтаксис скрипта — переименование

    Переименование файла — поскольку функции fileRename() нет, fileMove() работает так же хорошо

    fileMove(expandPath("./myFile.txt"), expandPath("./myNewFileName.txt"));

    Синтаксис скрипта — копирование

    Копирование файла

    fileCopy(expandPath("./myFile.txt"), expandPath("./some/other/path"));

    Синтаксис скрипта — перемещение

    Перемещение файла

    fileMove(expandPath("./myFile.txt"), expandPath("./some/other/path"));

    Синтаксис скрипта — удаление

    Удаление файла

    fileDelete(expandPath("./myFile.txt"));

    Синтаксис скрипта — загрузка

    Загрузка файла

    fileUpload(getTempDirectory(), "form.myFile", " ", "makeunique");

    Синтаксис скрипта — загрузка всех файлов

    Загрузка всех файлов

    fileUploadAll(getTempDirectory(), " ", "makeunique");

    Синтаксис тега (action=write)

    Запись содержимого переменной в файл.

    <cffile action="write" file="#expandPath("./myFile.txt")#" output="Here's some content for my file.">

    Синтаксис тега (action=append)

    Добавление содержимого в конец файла.

    <cffile action="append" file="#expandPath("./myFile.txt")#" attributes="normal" output="Here's some new content.">

    Синтаксис тега (action=read)

    Чтение файла в переменную

    <cffile action="read" file="#expandPath("./myFile.txt")#" variable="myFile">

    Синтаксис тега (action=readBinary)

    Чтение бинарных данных из файла

    <cffile action="readBinary" file="#expandPath("./myImage.jpg")#" variable="myImageBinary">

    Синтаксис тега (action=rename)

    Переименование файла

    <cffile action="rename" source="#expandPath("./myFile.txt")#" destination="#expandPath("./myNewFileName.txt")#" attributes="normal">

    Синтаксис тега (action=copy)

    Копирование файла

    <cffile action="copy" source="#expandPath("./myFile.txt")#" destination="#expandPath("./some/other/path")#">

    Синтаксис тега (action=move)

    Перемещение файла

    <cffile action="move" source="#expandPath("./myFile.txt")#" destination="#expandPath("./some/other/path")#">

    Синтаксис тега (action=delete)

    Удаление файла

    <cffile action="delete" file="#expandPath("./myFile.txt")#">

    Синтаксис тега (action=upload)

    Загрузка файла, содержащегося в поле myFile. Всегда загружайте файлы в каталог за пределами корневого каталога веб-сервера, проверяйте расширение и содержимое файла и только затем, при необходимости, копируйте его обратно в корневой каталог веб-сервера.

    <cffile action="upload" destination="#getTempDirectory()#" filefield="form.myFile" nameconflict="makeunique">

    Синтаксис тега (action=upload) с атрибутом accept

    CF 10+ Проверяет расширения файлов по списку разрешённых расширений. При указании списка расширений файлов необходимо задать strict=false.

    <cffile action="upload" accept=".png,.jpg" strict="false" destination="#getTempDirectory()#" filefield="form.myFile" nameconflict="makeunique">

    Синтаксис тега (action=uploadall)

    Загрузка всех файлов из области формы.

    <cffile action="uploadall" destination="#getTempDirectory()#" nameconflict="makeunique">

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

    Spec-Zone.ru

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