Adobe ColdFusion 8

cfheader

Description

Generates custom HTTP response headers to return to the client.

Category

Data output tags, Page processing tags

Syntax

<cfheader 
    charset="character set"
    name = "header name"
    value = "header value">

OR

<cfheader 
    statusCode = "status code"
    statusText = "status text">

Note: You can specify this tag's attributes in an attributeCollection attribute whose value is a structure. Specify the structure name in the attributeCollection attribute and use the tag's attribute names as structure keys.

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.

Attributes

Attribute

Req/Opt

Default

Description

charset

Optional

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, see www.w3.org/International/O-charset.html.

name

Required if statusCode not specified

 

Header name.

statusCode

Required if name not specified

 

Number. HTTP status code.

statusText

Optional

 

Explains the status code.

value

Optional

 

HTTP header value.

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())#">