fileUploadAll
Uploads all files sent to the page in an HTTP request to a directory on the server.
fileUploadAll(destination [,mimeType] [,onConflict] [,strict] [,continueOnError] [,errorVariable] [,allowedExtensions]) → returns array
Argument Reference
destination string Required
Path of directory in which to upload the file. If not an absolute path (starting with a drive letter and a colon, or a forward or backward slash), it is relative to the ColdFusion temporary directory returned by the function getTempDirectory. If the destination you specify does not exist, ColdFusion creates a file with the specified destination name.
mimeType string
Limits the MIME types to accept. Comma-delimited list. For example, the following code permits JPEG and Microsoft Word file uploads:'image/jpg,application/msword' .The browser uses the filename extension to determine file type.
onConflict string
Default: error
error
Action to take if file has the same name of a file in the directory.
Values:
errorskipoverwritemakeUnique
strict boolean
Default: true
true
Defines which method is used to determine the file type to check against the value of the
mimeType parameter.true: The first few bytes of the uploaded file are used to determine the MIME type.false: The MIME type provided by the browser in the request payload is used. continueOnError boolean
Default: false
false
CF 11+ Whether to continue uploading the remaining files when uploading one of the files fails.
errorVariable variableName
Default: cffile.uploadAllErrors
cffile.uploadAllErrors
CF 11+ The name of the variable in which the array of structs of file upload errors will be stored. The upload failure information error structure contains the following fields:
REASON - The reason for the failureDETAIL - File upload failure detailMESSAGE - A detailed message depicting the failureCLIENTFILE - Name of the file uploaded from the client's systemCLIENTFILEEXT - Extension of the uploaded file on the client system (without a period)CLIENTFILENAME - Name of the uploaded file on the client system (without an extension)INVALID_FILE_TYPE - If the file mime type or extension is not in the specified accept attribute. If the reason is INVALID_FILE_TYPE, two additional keys will be available in the structure. --ACCEPT: list of mime types or file extensions given in the tag--MIMETYPE: mime type of the uploaded fileEMPTY_FILE - If the uploaded file is an empty fileFILE_EXISTS - If any file with the given name already exists in the destination and the overwritepolicy is errorDEST - The destination where file is copiedFORM_FILE_NOT_FOUND - If the uploaded file is not found on the server allowedExtensions string
CF 2018+ A comma-separated list of file extensions, which will be allowed for upload. For example, .png, .jpg, or, .jpeg. You can use
* (star) to allow all files, except where you specify the MIME type in the accept attribute. Values specified in the attribute allowedExtensions override the list of blocked extensions in the server or application settings. Examples Sample code invoking the fileUploadAll function
© 2012–present Foundeo, Inc. and the CFDocs contributors.
Licensed under the MIT License.
ColdFusion is a trademark of Adobe Systems Incorporated.
https://cfdocs.org/fileuploadall
