ColdBox Configuration

Default Configuration
The default configuration file for CacheBox within ColdBox applications can be found here
/coldbox/system/web/config/CacheBox.cfc
This configuration file configures CacheBox with two caches:
default
template
The default cache can be used for any type of data caching or object persistence. The template cache is used for event caching and view fragment caching. It is also important to note that the template cache uses the ConcurrentSoftReferenceStore for its objects and the default cache uses the ConcurrentStore for its objects.
This means that event/view caching is subject to available memory via the JVM, a memory sensitive cache. This is essential as you could have lots of events being cached and you want to be considerate with memory concerns. It is also limited to 300 objects.
Now, this is all nice and dandy, but what if I want to configure CacheBox "MY WAY!!"? Well, don't shout, we are just getting there. There are several ways you can configure CacheBox from within your applications, so chose wisely.
Custom Configuration
ColdBox allows for a programmatic approach via the ColdBox configuration object: Coldbox.cfc. So let's look at how the framework loader looks at your configuration for CacheBox configuration details:
Is there a cachebox DSL variable defined in the configuration structure?
False:
Does a CacheBox.cfc exist in the application's config folder?
True : Use that for configuration
False: Configure CacheBox with default framework settings found in /coldbox/system/web/config/CacheBox.cfc
True:
Have you defined a configFile key in the cacheBox DSL structure?
True: Then use that value to pass into the configuration object so it can load CacheBox using that configuration CFC
False: The configuration data (CacheBox DSL) is going to be defined inline here so use that structure for configuration
Info The configuration DSL is exactly the same as you have seen in before with the only distinction that you can add a configFile key that can point to an external configuration CFC.
cacheBox = {
    configFile = "mypath.config.CacheBoxConfig"
};
That's it folks! You can either write inline CacheBox DSL configuration, use by convention a CacheBox.cfc data CFC or use a configFile approach for external file loading. Pick your poison!

CacheBox Config Object

Next - Usage

Cache Providers

Copy link

Edit on GitHub

On this page

Default Configuration

Custom Configuration