ColdBox MVC Platform Documentation

Configuration Directives

Last updated 6 months ago

The basic configuration object has 1 method for application configuration called configure() where you will place all your configuration directives and settings:
ColdBox.cfc
/**
* A simple CFC that configures a ColdBox application.  You can even extend, compose, strategize and do your OO goodness.
*/
component{
​
    // Mandatory configuration method
    function configure(){
        coldbox = {
          appName ="My App"
        };
    }
    
}
Please note that the only required directive is coldbox.appName.
Directives
Inside of this configuration method you will place several core and third-party configuration structures that can alter your application settings and behavior. Below are the core directives you can define:
Directive
Type
Description
​cachebox​
struct
An optional structure used to configure CacheBox. If not setup the framework will use its default configuration found in /coldbox/system/web/config/CacheBox.cfc
​coldbox​
struct
The main coldbox directives structure that holds all the coldbox settings.
​conventions​
struct
A structure where you will configure the application convention names
​datasources​
struct
An optional metadata structure for datasource definitions. THEY ARE NOT COLDFUSION REGISTRATIONS
​environments​
struct
A structure where you will configure environment detection patterns
​flash​
struct
A structure where you will configure the FlashRAM​
​interceptorSettings​
struct
An optional structure to configure application wide interceptor behavior
​interceptors​
array
An optional array of interceptor declarations for your application
​layoutSettings​
struct
A structure where you define how the layout manager behaves in your application
​layouts​
array
An array of layout declarations for implicit layout-view-folder pairings in your application
​logbox​
struct
An optional structure to configure the logging and messaging in your application via LogBox
​modules​
struct
An optional structure to configure application wide module behavior
​moduleSettings​
struct
An optional structure to configure individual modules installed in your application.
​settings​
struct
A structure where you can put your own application settings
​wirebox​
struct
An optional structure used to define how WireBox is loaded

ColdBox.cfc

CacheBox

Directive	Type	Description
cachebox	struct	An optional structure used to configure CacheBox. If not setup the framework will use its default configuration found in `/coldbox/system/web/config/CacheBox.cfc`
coldbox	struct	The main coldbox directives structure that holds all the coldbox settings.
conventions	struct	A structure where you will configure the application convention names
datasources	struct	An optional metadata structure for datasource definitions. THEY ARE NOT COLDFUSION REGISTRATIONS
environments	struct	A structure where you will configure environment detection patterns
flash	struct	A structure where you will configure the FlashRAM
interceptorSettings	struct	An optional structure to configure application wide interceptor behavior
interceptors	array	An optional array of interceptor declarations for your application
layoutSettings	struct	A structure where you define how the layout manager behaves in your application
layouts	array	An array of layout declarations for implicit layout-view-folder pairings in your application
logbox	struct	An optional structure to configure the logging and messaging in your application via LogBox
modules	struct	An optional structure to configure application wide module behavior
moduleSettings	struct	An optional structure to configure individual modules installed in your application.
settings	struct	A structure where you can put your own application settings
wirebox	struct	An optional structure used to define how WireBox is loaded