CFHEADER  
Description

Generates custom HTTP response headers to return to the client.

 
Category

Data output tags, Page processing tags

 
Syntax
<cfheader 
   name = "header_name"
   value = "header_value"
   charset="charset">
or
<cfheader 
   statusCode = "status_code"
   statusText = "status_text">
 
See also

cfcache, cfflush, cfhtmlhead, cfinclude, cfsetting, cfsilent, cfcontent

 
History

ColdFusion MX 6.1: Changed behavior for the name attribute: cfheader name="Content-Disposition" uses the default file character encoding to encode this header's value, so the name of a file can include characters in the character encoding used in the file.

 
Usage

If you use this tag after the cfflush tag on a page, an error is thrown.

 
Example
<h3>cfheader Example</h3>

<p>cfheader generates custom HTTP response headers to return to the client. 
<p>This example forces browser client to purge its cache of requested file. 
<cfheader name="Expires" value="#GetHttpTimeString(Now())#">
NAME  
  Required if statusCode not specified
 

Header name.

VALUE  
  Optional
 

HTTP header value.

CHARSET  
  Optional
 
Default value: "UTF-8"

The character encoding in which to encode the header value. The following list includes commonly used values:

  • utf-8
  • iso-8859-1
  • windows-1252
  • us-ascii
  • shift_jis
  • iso-2022-jp
  • euc-jp
  • euc-kr
  • big5
  • euc-cn
  • utf-16

For more information about character encodings, seewww.w3.org/International/O-charset.html.

STATUSCODE  
  Required if name not specified
 

Number. HTTP status code.

STATUSTEXT  
  Optional
 

Explains the status code.