User Guide

124 Chapter 2: ColdFusion Tags
cffile action = "upload"
Description
Copies a file to a directory on the server.
Syntax
<cffile
action = "upload"
fileField = "formfield"
destination = "full_path_name"
nameConflict = "behavior"
accept = "mime_type/file_type"
mode = "permission"
attributes = "file_attribute_or_list">
See also
cfdirectory
History
See the History section of the main cffile tag page.
Attributes
Attribute Req/Opt Default Description
action Required Type of file manipulation that the tag performs.
fileField Required Name of form field used to select the file.
Do not use pound signs (#) to specify the field name.
destination Required Pathname of directory in which to upload the file. If not an
absolute path (starting a with a drive letter and a colon, or a
forward or backward slash), it is relative to the ColdFusion
temporary directory, which is returned by the
GetTempDirectory function.
nameConflict Optional Error Action to take if filename is the same as that of a file in the
directory.
• Error: file is not saved. ColdFusion stops processing the
page and returns an error.
• Skip: file is not saved. This option permits custom behavior
based on file properties.
• Overwrite: replaces file.
• MakeUnique: forms a unique filename for the upload; name
is stored in the file object variable
serverFile.
accept Optional Limits the MIME types to accept. Comma-delimited list. For
example, to permit JPG and Microsoft Word file uploads:
accept = "image/jpg, application/msword"
The browser uses file extension to determine file type.