Supporting If-Modified-Since HTTP header in CFML

February 18, 2005

The If-Modified-Since header in the HTTP protocol allows user agents (typically RSS aggregators, or Spiders) to check and see if the content they are about to download has changed since their last visit. The user agent sends something like this in the headers:

If-Modified-Since: Fri, 18 Feb 2005 19:24:26 GMT

You can access this header from CFML, compare the date your content was last changed, and then if the content was not modified since the date passed, you return a 304 status code. If the content has been modified, you just return the content as you normally would. Here's some example CFML you can put at the top of your page, you need to update the pageModificationDate:

<cfif StructKeyExists(GetHttpRequestData().headers, "If-Modified-Since")>
	<cfset ifmodDate = ParseDateTime(GetHttpRequestData().headers["If-Modified-Since"])>
	<cfset pageModificationDate = GetHttpTimeString(ParseDateTime(Now()))>
	<cfif DateDiff("n", pageModificationDate, ifmodDate) GT 0>
		<cfheader statuscode="304" statustext="Not Modified"> 
<cfcatch type="any"></cfcatch>

I use the GetHttpRequestData() function to get the value of the If-Modified-Since header (notice that I have to use StructKeyExists instead of IsDefined due to the dash - in the header name).

Also note that the dates need to be formatted properly, use the GetHttpTimeString() function for this.

I also put in a try/catch block to catch any date parsing errors, that way if there is an error parsing a date sent by a bad client, they still get the content, you may decide to log the error, or give a 500 level status code to such clients.

I implemented this with my RSS feed for this blog, so I should see a decrease in bandwidth on my RSS feed. Well written aggregators will only get content when my feed is updated, and just the headers otherwise.

Related Entries

3 people found this page useful, what do you think?


Pete: A couple notes. (1) The provided code won't do much good, since you're not setting Last-Modified in the first place. Every request to your feed will continue to produce a 200, and thus a full bandwidth hit. (2) If-Modified-Since is only half of Conditional GET. You also need to support Etags if you're really interested in minimizing excess 200s. Once you have Etags working, the next step is RFC3229, which can be leveraged to deliver feed deltas to clients that send the appropriate header. (Most of them, at this point.) However, 3229 might be overkill for the average, individual blog... it's more useful for services like JournURL, that are producing thousands of different feeds.
used in meta
Hi Pete,
I am SEO & i address this issue of not having If modified since in my clients website made with coldfusion. I found this article as a solution and asked the developer to do it & he did. Now when i check if modified since using one tool at
I can see current date and time as last modified, but my website is not uploaded in last five minutes. I tryed doing it again, again same time & date.
It is not showing last date and time my website was updated. I doubt SE may not consider me as Back hat. Please give your review, code i have used <CFHEADER NAME="If-Modified-Since" VALUE=#GetHttpTimeString(ParseDateTime(Now()))#>
my websites is i am thinking to remove this code, what do you say??

Post a Comment


Spell Checker by Foundeo

Recent Entries


did you hack my cf?