FileUploadAll()

edit

Saves files from all the form fields in a request to a specified directory/resource.

Also supports processing multiple file uploads from a single form field, i.e. <input type="file" name="file" multiple>

it return the status of the upload operation as array of struct after all files upload.

FileUploadAll( destination=string, accept=string, nameConflict=string, strict=boolean, allowedExtensions=any, blockedExtensions=any, strict=string, attributes=string, acl=object );

Returns: Array

Argument Description
destination
string, required 		edit

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

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 		edit

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

  • skip
  • error
  • overwrite
  • makeunique

Alias: onConflict
strict
boolean, optional 		edit

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

String list or string array of allowed extensions.

Introduced: 6.0.0.12
blockedExtensions
any, optional 		edit

String list or string array of not allowed extensions.

Introduced: 6.0.0.12
strict
string, optional 		edit

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

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 		edit

Only used for S3 Resources

Examples

edit 
<form name="myUpload" method="post" enctype="multipart/form-data">
    <input type="file" name="fileDataOne">
    <input type="file" name="fileDataTwo">
    <input type="file" name="fileDataThree">

    <input type="submit" name="submit">
</form>
<cfscript>
    if (structKeyExists(form, "submit")){
        uploadfile = fileuploadAll(getTempDirectory(),"","makeunique");
        writeDump(uploadfile);
    }
</cfscript>

Related System Properties / Environment Variables

  • LUCEE_FILEUPLOAD_ALLOW_MIMETYPE_DETECTION - Boolean value that enables using Tika to detect the mime type for unknown file uploads
    Type: boolean, Default: true, Introduced: 7.0.0.312
  • LUCEE_UPLOAD_BLOCKLIST - Default block list for the tag cffile action=`upload`. A comma-separated list of extensions that are allowed when uploading files via forms
    Type: string

See also