Using CFHeader With File Names Containing Spaces (Thanks Elliott Sprehn!)
Posted July 18, 2007 at 6:28 PM
Just a minor note that I thought I would post up here (since I didn't know this before and I had to test it for myself). When it comes to web development, pretty much all of my file names are purely alpha-numeric with underscores for spaces. As such, I have never come up against a problem in ColdFusion where I needed to used space-containing file names in conjunction with the CFHeader content-disposition value. In fact, I've never even thought about it.
In my post on using additional path information to alter the browser's Save-As behavior, Elliott Sprehn pointed out to me that in order to handle spaces in file names, you have to quote the file names. And, not only do you have to quote it, you have to use double quotes, NOT single quotes - single quotes do nothing to help you out and the first single quote actually shows up in the file name (before the name gets truncated).
Here is my test ColdFusion template. All it does is try to server up a file as an attachment:
Launch code in new window » Download code as text file »
- <!--- Kill extra output. --->
- <cfsilent>
-
- <cfheader
- name="content-disposition"
- value="attachment; filename=""This Is A Test.txt"""
- />
-
- <cfcontent
- type="text/plain"
- variable="#ToBinary( ToBase64( 'Test Data' ))#"
- />
-
- </cfsilent>
Notice that in order to get the quotes to work, you have to double them up (otherwise ColdFusion will think you are ending the string). You could also use single quotes for the value attribute, but that's not my style.
Running the above template directly, I am correctly prompted by FireFox to download the file with the proper name:
| | | | ||
| |  | | ||
| | | |
I probably won't switch over to using file names with spaces, but in something like a document management system, I can see where knowing this would be super helpful.
Download Code Snippet ZIP File
Post Comment | Ask Ben | Permalink | Other Searches | Print Page
Newer Post
Learning ColdFusion 8: CFZip Part III - Reading Zip File Entries
Older Post
Exploring Path Info And How It Interacts With ColdFusion And The Browser
Reader Comments
I think you have triple quotes at the end there...
Sami, the third quote is closing the one started at:
value="attachment
Another reason not to use spaces in filenames. Would it work if you substituted them with %20 ?
@Duncan,
I just tried it and the %20 actually shows up in the file name.
Is this actually ColdFusion doing this, or the browser?
@Peter,
When I look at the http headers that get sent back with the file request (Thanks god for FireBug!!), the double quotes are coming back in the actual header value:
filename="your file name"
Therefore, I assume it is the browser that requires them. If it was ColdFusion handling it, I am sure the use of double OR single quotes wouldn't matter.
You're welcome Ben!
@Peter
It's the browser. http://kb.mozillazine.org/Filenames_with_spaces_are_truncated_upon_download
Did you know that IE7 puts underscores in the name of the file when you use the double quote method? I have an Intranet Document Management System that has been working great until we upgraded to IE7. If you take out the double quotes, it works perfectly for IE7.
Any ideas other than recognizing the browser and placing separate code for each? I'm thinking I have no choice at this point.
JC
@JC,
Sorry, no ideas. I haven't even upgraded to IE7 yet, so I wouldn't even know how to test.
Thanks for this, never thought of putting double quotes - was putting single quotes and of course they didn't work.
Another few hours saved because of your excellent blog - thanks!
@Felix,
Glad to help out :)
Thanks! Always had this problem and I was stripping the spaces to the consternation of the users who wanted to preserve the file name.
Thanks a ton Ben!!!
Google + Ben Nadel save the day again!
@Mac, @Will,
Glad to help out fellas.
I actually did it this way;
<cfheader name="Content-Disposition" value="attachment;filename=#chr(34)##getimage.originalfile##chr(34)#">
@Mark,
Nice, that should work. By using the chr() method, you don't have to escape the quotes by doubling them up. Good thinking.
