FUNCTION:SYSTEMCACHECLEAR

SystemCacheClear

Back to functions

Description

Railo has several function and tags which can be used to clear Railo system caches. These functions are:

• customTagCacheClear
• componentCacheClear
• PagePoolCacheClear
• <cfobjectcache action="clear">

This function that handles all these cache clear functions and tags. Existing functions are now set to be deprecated.

The single argument contains the name of the cache to clear. If no argument is passed all caches will be cleared. The following cache Names are supported:

• all: clears all caches
• template: clears the template cache
• component: clears the component path cache
• customtag: clears the custom tag path cache
• query: clears the query cache
• tag: clears the cfml/cfc based built in tag cache
• function: clears the cfml based built in function cache

The tag <cfobjectcache> is not deprecated since it contains also a filter that allows you to granularly define which elements should be flushed from the cache.

You can clear a specific cache by passing it's name in, example:

systemcacheclear("component")

Which would clear the component path cache.

Category

Other

Usage Syntax

SystemCacheClear([string cacheName])

Return Information

Arguments

Example Usage

<cfset SystemCacheClear("all")>
<cfset SystemCacheClear("component")>

History

Railo 3.3: Introduced the function.