Contents

cfapplication

Description

Defines scoping for a ColdFusion application, enables or disables storing client variables, and specifies a client variable storage mechanism. By default, client variables are disabled. Also, enables session variables and sets timeouts for session and application variables. Session and application variables are stored in memory.

Category

Other

Implemented

Usage Syntax

<cfapplication  
	[name="String"]
	[action="String"]
	[loginStorage="String"]
	[clientManagement="Boolean"]
	[clientStorage="String"]
	[setClientCookies="Boolean"]
	[sessionManagement="Boolean"]
	[sessionTimeout="timespan"]
	[applicationTimeout="timespan"]
	[setDomainCookies="Boolean"]
	[scriptProtect="String"]
	[mappings="Struct"]
	[customtagpaths="Any"]
	[secureJson="Boolean"]
	[secureJsonPrefix="String"]
 />

[] = Optional attribute

Attributes

Name Type Required Default Description
name String No The name of your application. This name can be up to 64 characters long. Required for application and session variables, optional for client variables
action String No
loginStorage String No
clientManagement Boolean No Yes or No. Enables client variables. Default is No.
clientStorage String No Specifies how ColdFusion stores client variables
setClientCookies Boolean No Yes or No. Yes enables client cookies. Default is Yes. If you set this attribute to "No", ColdFusion does not automatically send the CFID and CFTOKEN cookies to the client browser; you must manually code CFID and CFTOKEN on the URL for every page that uses Session or Client variables.
sessionManagement Boolean No Yes or No. Yes enables session variables. Default is No.
sessionTimeout timespan No Enter the CreateTimeSpan function and values in days, hours, minutes, and seconds, separated by commas, to specify the lifespan of session variables. The default value is specified in the Variables page of the ColdFusion Administrator.
applicationTimeout timespan No Enter the CreateTimeSpan function and values in days, hours, minutes, and seconds, separated by commas, to specify the lifespan of application variables. The default value is specified in the Variables page of the ColdFusion Administrator.
setDomainCookies Boolean No Yes or No. Sets the CFID and CFTOKEN cookies for a domain, not just a single host. Applications that are running on clusters must set this value to Yes. The default is No.
scriptProtect String No Specifies whether to protect variables from cross-site scripting attacks
mappings Struct No Mappings applied to the current application. Ex: { '/admin' = '/var/www/admin' } would map any absolute reference to '/admin' to '/var/www/admin'. This would also apply to component paths such as 'admin.cfcs.example'.
customtagpaths Any No
secureJson Boolean No
secureJsonPrefix String No

Example Usage