Ask Ben: Uploading Multiple Files Using ColdFusion

Posted January 8, 2008 at 8:53 AM

Tags: Ask Ben, ColdFusion

After posting a while back about uploading a file and emailing it using ColdFusion, I was asked to put up a demo of how to upload multiple files using ColdFusion. For this demo, I am concentrating only on the upload aspect and not worrying about any emailing functionality as I believe that adding that is easy after the upload is complete.

Before I show the code, I just want to preempt some stuff. For starters, I am using a LOT Of error handling via ColdFusion's CFTry / CFCatch tags. In practice, I don't really use that much error handling. However, I am just trying to instill some good practice here and drive home the fact that when dealing with a third party service (the file system), there is always potential for errors to occur. And, the truth is, I should really use better error handling anyway.

That being said, this code is only partially tested as I could not generate any errors on the file upload. I think the error handling looks good, but again, not fully tested. The best that I could do was to change the NameConflict attribute in the CFFile tag from MakeUnique to Error and upload two files of the same name, which threw the following error:

There was a problem uploading file #2: File overwriting is not permitted in this instance of the CFFile tag.

So, it seems to be working; but, I just want to stress that I couldn't generate a file system error and therefore some of this code is still theoretical.

Additionally, I build the page such that the number of files to be uploaded can be variable. Right now, it is set to have 5 file fields, but that can be set using the REQUEST.FileCount variable. I know that this kind of stuff is handled very Web 2.0 dynamic style these days, but for this demo, I wanted to keep it really simple and straight forward.

That being said, here is the code:

 Launch code in new window » Download code as text file »

  • <!---
  • Set the number of files that can uploaded in a single
  • form submission.
  • --->
  • <cfset REQUEST.FileCount = 5 />
  •  
  • <!--- Set the destination folder for uploads. --->
  • <cfset REQUEST.UploadPath = ExpandPath( "./uploads/" ) />
  •  
  •  
  •  
  • <!--- Param the appropriate number of file fields. --->
  • <cfloop
  • index="intFileIndex"
  • from="1"
  • to="#REQUEST.FileCount#"
  • step="1">
  •  
  • <!--- Param file value. --->
  • <cfparam
  • name="FORM.file#intFileIndex#"
  • type="string"
  • default=""
  • />
  •  
  • </cfloop>
  •  
  •  
  • <!--- Param upload flag. --->
  • <cftry>
  • <cfparam
  • name="FORM.submitted"
  • type="numeric"
  • default="0"
  • />
  •  
  • <cfcatch>
  • <cfset FORM.submitted = 0 />
  • </cfcatch>
  • </cftry>
  •  
  •  
  • <!--- Set up an array to hold errors. --->
  • <cfset arrErrors = ArrayNew( 1 ) />
  •  
  •  
  • <!--- Check to see if the form has been submitted. --->
  • <cfif FORM.submitted>
  •  
  • <!---
  • Here is where we would validate the data; however,
  • in this example, there really isn't anything to
  • validate. In order to validate something, we are going
  • to require at least one file to be uploaded!
  • --->
  •  
  •  
  • <!---
  • Since we are going to require at least one file, I am
  • going to start off with an error statement. Then, I am
  • gonna let the form tell me to DELETE IT.
  • --->
  • <cfset ArrayAppend(
  • arrErrors,
  • "Please select at least one file to upload"
  • ) />
  •  
  •  
  • <!--- Loop over the files looking for a valid one. --->
  • <cfloop
  • index="intFileIndex"
  • from="1"
  • to="#REQUEST.FileCount#"
  • step="1">
  •  
  • <cfif Len( FORM[ "file#intFileIndex#" ] )>
  •  
  • <!--- Clear the errors array. --->
  • <cfset ArrayClear( arrErrors ) />
  •  
  • <!--- Break out of loop. --->
  • <cfbreak />
  •  
  • </cfif>
  •  
  • </cfloop>
  •  
  •  
  • <!---
  • Check to see if there were any form validation
  • errors. If there are no errors, then we can continue
  • to process the form. Otherwise, we are going to skip
  • this and just let the page render again.
  • --->
  • <cfif NOT ArrayLen( arrErrors )>
  •  
  • <!---
  • Create an array to hold the list of uploaded
  • files.
  • --->
  • <cfset arrUploaded = ArrayNew( 1 ) />
  •  
  •  
  • <!---
  • Loop over the form fields and upload the files
  • that are valid (have a length).
  • --->
  • <cfloop
  • index="intFileIndex"
  • from="1"
  • to="#REQUEST.FileCount#"
  • step="1">
  •  
  • <!--- Check to see if file has a length. --->
  • <cfif Len( FORM[ "file#intFileIndex#" ] )>
  •  
  • <!---
  • When uploading, remember to use a CFTry /
  • CFCatch as complications might be encountered.
  • --->
  • <cftry>
  • <cffile
  • action="upload"
  • destination="#REQUEST.UploadPath#"
  • filefield="file#intFileIndex#"
  • nameconflict="makeunique"
  • />
  •  
  • <!---
  • Store this file name in the uploaded file
  • array so we can reference it later.
  • --->
  • <cfset ArrayAppend(
  • arrUploaded,
  • (CFFILE.ServerDirectory & "\" & CFFILE.ServerFile)
  • ) />
  •  
  •  
  • <!--- Catch upload errors. --->
  • <cfcatch>
  •  
  • <!--- Store the error. --->
  • <cfset ArrayAppend(
  • arrErrors,
  • "There was a problem uploading file ###intFileIndex#: #CFCATCH.Message#"
  • ) />
  •  
  • <!---
  • Break out of the upload loop as we
  • don't want to deal with any more
  • files than we have to.
  • --->
  • <cfbreak />
  •  
  • </cfcatch>
  • </cftry>
  •  
  • </cfif>
  •  
  • </cfloop>
  •  
  •  
  • <!--- Check to see if we have any form errors. --->
  • <cfif ArrayLen( arrErrors )>
  •  
  •  
  • <!---
  • We encountered an error somewhere in the upload
  • process. As such, we want to clean up the server
  • a bit by deleteing any files that were
  • successfully uploaded as part of this process.
  • --->
  • <cfloop
  • index="intFileIndex"
  • from="1"
  • to="#ArrayLen( arrUploaded )#"
  • step="1">
  •  
  • <!--- Try to delete this file. --->
  • <cftry>
  • <cffile
  • action="delete"
  • file="#arrUploaded[ intFileIndex ]#"
  • />
  •  
  • <cfcatch>
  • <!--- File could not be deleted. --->
  • </cfcatch>
  • </cftry>
  •  
  • </cfloop>
  •  
  •  
  • <cfelse>
  •  
  •  
  • <!---
  • !! SUCCESS !!
  • The files were properly uploaded and processed.
  • Here is where you might forward someone to some
  • sort of success / confirmation page.
  • --->
  •  
  •  
  • </cfif>
  •  
  • </cfif>
  •  
  • </cfif>
  •  
  •  
  • <!--- Set the content type and reset the output buffer. --->
  • <cfcontent
  • type="text/html"
  • reset="true"
  • />
  •  
  • <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  • <html>
  • <head>
  • <title>Multiple File Uploads</title>
  • </head>
  • <body>
  •  
  • <cfoutput>
  •  
  • <h1>
  • Multiple File Upload ColdFusion Example
  • </h1>
  •  
  •  
  • <!--- Check to see if we have any errors to display. --->
  • <cfif ArrayLen( arrErrors )>
  •  
  • <p>
  • Please review the following errors:
  • </p>
  •  
  • <ul>
  • <cfloop
  • index="intError"
  • from="1"
  • to="#ArrayLen( arrErrors )#"
  • step="1">
  •  
  • <li>
  • #arrErrors[ intError ]#
  • </li>
  •  
  • </cfloop>
  • </ul>
  •  
  • </cfif>
  •  
  •  
  • <form
  • action="#CGI.script_name#"
  • method="post"
  • enctype="multipart/form-data">
  •  
  • <!--- Submission flag. --->
  • <input type="hidden" name="submitted" value="1" />
  •  
  •  
  • <!---
  • Loop over the number of files we are going to
  • allow for the upload.
  • --->
  • <cfloop
  • index="intFileIndex"
  • from="1"
  • to="#REQUEST.FileCount#"
  • step="1">
  •  
  • <label for="file#intFileIndex#">
  • File #intFileIndex#:
  • </label>
  •  
  • <input
  • type="file"
  • name="file#intFileIndex#"
  • id="file#intFileIndex#"
  • />
  •  
  • <br />
  •  
  • </cfloop>
  •  
  •  
  • <input type="submit" value="Upload Files" />
  •  
  • </form>
  •  
  • </cfoutput>
  •  
  • </body>
  • </html>

Hope that helps. Please let me know if there are any follow up questions.

Download Code Snippet ZIP File

Comments (4)  |  Post Comment  |  Ask Ben  |  Permalink  |  Other Searches  |  Print Page




Adobe ColdFusion 8.0.1 Update - Helping Programmers To Be Signifanctly Less Girlie - Download ColdFusion 8 Update 8.0.1 Now.

Reader Comments

Just wondering why you add the step="1" attribute on all your cfloops?

Posted by duncan on Jan 8, 2008 at 11:06 AM


@Duncan,

There is no technical reason for this. I know that the loop increment defaults to 1. However, since many of my posts are meant to help people learn, I believe that it is best to spell everything out explicitly so there is no mystery and people can concentrate on the real task at hand.

Posted by Ben Nadel on Jan 8, 2008 at 11:11 AM


A nice addition for the beginners out there might be to use the result attribute and show'em how it can be used to interact with the db.

Great post!

Will

Posted by Will on Jan 8, 2008 at 11:02 PM


thank you for this, very helpful

Posted by Glyn on Feb 6, 2008 at 7:04 AM


Post Comment  |  Ask Ben


Home   |   Web Log   |   ColdFusion   |   Projects   |   Resume   |   Job Form   |   Search   |   Contact
Epicenter Consulting - Custom Software Solutions for Business Evolution HostMySite.com - The Leader In ColdFusion Hosting