FileUpload()

Uploads file to a directory on the server.

FileUpload( destination=string, fileField=string, accept=string, nameConflict=string, mode=string, attributes=string, acl=object );

Returns: Struct

Argument Description
destination
string, required

Absolute pathname of directory or file on web server.
fileField
string, optional

Name of form field used to select the file.
accept
string, 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.
nameConflict
string, optional

Action to take if filename is the same as that of a file in the directory.

  • skip
  • error
  • overwrite
  • makeunique

Alias: onConflict
mode
string, optional

Applies only to Solaris and HP-UX. Permissions. Octal values of UNIX chmod command. Assigned to owner, group, and other, respectively.
attributes
string, optional

One attribute (Windows) or a comma-delimited list of attributes (other platforms) to set on the file. If omitted, the file's attributes are maintained.
acl
object, optional

only used for S3 Resources

Examples

<form name="myUpload" method="post" enctype="multipart/form-data">
    <input type="file" name="fileData">
    <input type="submit" name="submit">
</form>
<cfscript>
    if (structKeyExists(form, "fileData") and len(form.fileData) ){
        uploadfile = fileupload(getTempDirectory(),"form.fileData"," ","makeunique");
        writeDump(uploadfile);
    }
</cfscript>

See also