8

I am "renaming" an existing file for a project I am working on. To maintain backwards compatibility, I am leaving a cfm file in place to redirect the users to the new one.

  • buy.cfm: old
  • shop.cfm: new

In order to keep everything as clean as possible, I want to send the 301 statuscode response if a user tries to go to buy.cfm.

I know that I can use either cflocation with the statuscode attribute

<cflocation url="shop.cfm" statuscode="301" addtoken="false">

or I can use the cfheader tags.

<cfheader statuscode="301" statustext="Moved permanently">
<cfheader name="Location" value="http://www.mysite.com/shop.cfm">

Are there any reasons to use one method over the other?

James A Mohler
  • 11,060
  • 15
  • 46
  • 72
Joe C
  • 3,506
  • 2
  • 21
  • 32

3 Answers3

13

I think they do the same thing, with <cflocation> being more readable

Henry
  • 32,689
  • 19
  • 120
  • 221
  • 1
    Agree wirh Henry. The `cfheader` version is simply a manual version of what `cflocation` does for you. – Adam Cameron Jan 23 '13 at 07:04
  • 3
    OK, doing a bit more reading, it looks like the `statuscode` attribute was not added until CF8, so the cfheader was previously the only way to return the statuscode specifically. – Joe C Jan 23 '13 at 13:53
  • 1
    FYI - cflocation status code only accepts values between 300 and 307. So if, e.g., you need to return the location of a newly created resource along with a 201 status code you'll need to use cfheader. – Eric Fuller Jan 11 '17 at 22:34
8

I tested this on ColdFusion 9.

There is one major difference, and it is that cflocation stops execution of the page and then redirects to the specified resource.

From the Adobe ColdFusion documentation:

Stops execution of the current page and opens a ColdFusion page or HTML file.

So you would need to do this:

<cfheader statuscode="301" statustext="Moved permanently">
<cfheader name="Location" value="http://www.example.com/shop.cfm">
<cfabort>

to get the equivalent of this:

<cflocation url="shop.cfm" statuscode="301" addtoken="false">

Otherwise, you risk running into issues if other code runs after the cfheader tag. I came across this when fixing some code where redirects were inserted into an application.cfm file -- using cfheader -- without aborting the rest of the page processing.

I also noticed, in the response headers, that cflocation also sets the following headers accordingly:

Cache-Control: no-cache
Pragma: no-cache

One might want to add these headers in if using the cfheader tag with Location, if needed:

<cfheader name="Cache-Control" value="no-cache"> 
<cfheader name="Pragma" value="no-cache">
Leigh
  • 28,765
  • 10
  • 55
  • 103
Andy Tyrone
  • 81
  • 2
  • 2
0

To elaborate on the Answer by Andy Tyrone, while they MAY do the same thing in certain circumstances, the CFHEADER method give you more control over the headers passed in the request. This becomes useful, for example, if you want to send cache control headers to a browser or content delivery network so that they do not keep hitting your server with the same old redirect request. There is no way (to my knowledge) to tell a CFLocation to cache the redirect.

Rogi I.
  • 127
  • 1
  • 8