Overview ColdFusion Open BlueDragon Lucee

Manages interactions with server files. Different combinations cause different attributes to be required.


Name Required Type Default Description
accept No String Limits the MIME types to accept. Comma-delimited list. For example, to permit JPG and Microsoft Word file uploads: accept = "image/jpg, application/msword"
acl No only used for S3 Resources
action Yes String Type of file manipulation that the tag performs.
addnewline No Boolean true Yes: appends newline character to text written to file
attributes No String Applies to Windows. A comma-delimited list of attributes to set on the file. If omitted, the file's attributes are maintained.
charset No String The character encoding in which the file contents is encoded. For more information on character encodings, see:
createpath No for action "append", "touch" and "write": if set to false (default), expects all parent directories to exist, true will generate necessary directories
destination No String Pathname of a directory or file on web server (durring copy).
file No String Pathname of the file. Also supports ZIP files and files accessed using protocols HTTP, FTP and VFS.
filefield No String Name of form field used to select the file. Do not use pound signs (#) to specify the field name.
fixnewline No String false * Yes: changes embedded line-ending characters in string variables to operating-system specific line endings * No: (default) do not change embedded line-ending characters in string variables.
mode No String Applies only to UNIX and Linux. Permissions. Octal values of Unix chmod command. Assigned to owner, group, and other, respectively.
nameconflict No String Action to take if filename is the same as that of a file in the directory.
output No String String to add to the file
result No VariableName cffile Allows you to specify a name for the variable in which cffile returns the result (or status) parameters. If you do not specify a value for this attribute, cffile uses the prefix "cffile".
serverpassword No allow you to access filesystem, also when access is denied for your context
source No String Pathname of the file (durring copy).
storeacl No alias for attribute "acl"
strict No Boolean false Set strict='true' to have strict mime type checking for mime type specified in "accept" attribute, when action is upload or uploadAll.
uridirectory No Specify if the file location is a full path or a relative path.
variable No String Name of variable to contain contents of text file.