Description

Generates custom HTTP response headers to return to the client.

Category

Data output tagsPage processing tags

Syntax

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

cfcachecfflushcfhtmlheadcfincludecfsettingcfsilentcfcontent

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:

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

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy