MACROMEDIA COLFUSION MX 7-CFML, Reference

Page: 97 / 1108

cfcookie 97
cfcookie
Description
Defines web browser cookie variables, including expiration and security options.
Category
Forms tags , Variable manipulation tags
Syntax
<cfcookie
name = "cookie_name"
value = "text"
expires = "period"
secure = "yes" or "no"
path = "url"
domain = ".domain">
See also
cfdump , cfparam , cfregistry , cfsavecontent , cfschedule , cfset
History
ColdFusion MX 6.1:
•
Changed the
expires
attribute: it now accepts a date time object.
•
Cookie names can include all ASCII characters except commas, semicolons, or whitespace
characters.
Attributes
Attribute Req/Opt Default Description
name Required Name of cookie variable. ColdFusion converts cookie names to
all-uppercase. Cookie names set using this tag can include any
printable ASCII characters except commas, semicolons or white
space characters.
value Optional Value to assign to cookie variable. Must be a string or variable that
can be stored as a string.
expires Optional Expiration of cookie variable.
•
The default: the cookie expires when the user closes the
browser, that is, the cookie is "session only".
•
A date or date/time object (for example, 10/09/97)
•
A number of days (for example, 10, or 100)
•
now: deletes cookie from client cookie.txt file (but does not
delete the corresponding variable the Cookie scope of the
active page).
•
never: The cookie expires in 30 years from the time it was
created (effectively never in web years).