FileUpload()

Uploads file to a directory on the server.

it return the status of the upload operation as a struct after the file upload.

FileUpload( destination=string, fileField=string, accept=string, nameConflict=string, strict=boolean, allowedExtensions=any, blockedExtensions=any, 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.

Alias: mimeType
nameConflict
string, optional

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

  • skip
  • error
  • overwrite
  • makeunique
  • forceunique

Alias: onConflict
strict
boolean, optional

true (default), only mimetypes are supported in the accept attribute. if set to false, it supports file extension/mimetypes in the accept attribute
allowedExtensions
any, optional

String list or string array of allowed extensions.

Introduced: 6.0.0.12
blockedExtensions
any, optional

String list or string array of not allowed extensions.

Introduced: 6.0.0.12
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