Macromedia coldfusion 4.5-cfml language reference User Manual

30

CFCOOKIE

Defines cookie variables, including expiration and security options.

<CFCOOKIE NAME="cookie_name"

VALUE="text"
EXPIRES="period"
SECURE="Yes/No"
PATH="urls"
DOMAIN=".domain">

Required. The name of the cookie variable.

Optional. The value assigned to the cookie variable.

Optional. Schedules the expiration of a cookie variable. Can be specified as a date 
(as in, 10/09/97), number of days (as in, 10, 100), NOW, or NEVER. Using NOW 
effectively deletes the cookie from the client’s browser.

Optional. Indicates the variable has to transmit securely. If the browser does not 
support Secure Socket Layer (SSL) security, the cookie is not sent.

Optional. Specifies the subset of URLs within the specified domain to which this 
cookie applies:

PATH="/services/login"

Separate multiple entries with a semicolon ( ; ).

Specifies the domain for which the cookie is valid and to which the cookie content 
can be sent. An explicitly specified domain must always start with a dot. This can 
be a subdomain, in which case the valid domains will be any domain names 
ending in this string. 

For domain names ending in country codes (such as 

.jp

, 

.us

), the subdomain 

specification must contain at least three periods, for example, 

.mongo.stateu.us

. 

In the case of special top level domains, only two periods are needed, as in 

.allaire.com

. 

When specifying a PATH value, you must include a valid DOMAIN.

Separate multiple entries with a semicolon ( ; ).

Cookies written with CFCOOKIE do not get written to the 

cookies.txt

 file until the 

browser session ends. Until the browser is closed, the cookie resides in memory. If you