Class Configure

_getEnginesource protected static

_getEngine( string $config )

Get the configured engine. Internally used by Configure::load() and Configure::dump() Will create new PhpConfig for default if not configured yet.

Parameters

string $config

The name of the configured adapter

Returns

Cake\Core\Configure\ConfigEngineInterface|false
Engine instance or false

checksource public static

check( string $var )

Returns true if given variable is set in Configure.

Parameters

string $var

Variable name to check for

Returns

boolean
True if variable is there

clearsource public static

clear( )

Clear all values stored in Configure.

Returns

boolean
success.

configsource public static

config( string $name , Cake\Core\Configure\ConfigEngineInterface $engine )

Add a new engine to Configure. Engines allow you to read configuration files in various formats/storage locations. CakePHP comes with two built-in engines PhpConfig and IniConfig. You can also implement your own engine classes in your application.

To add a new engine to Configure:

Configure::config('ini', new IniConfig());

Parameters

string $name

The name of the engine being configured. This alias is used later to read values from a specific engine.

Cake\Core\Configure\ConfigEngineInterface $engine

The engine to append.

configuredsource public static

configured( string|null $name null )

Gets the names of the configured Engine objects.

Parameters

string|null $name optional null

Engine name.

Returns

array
Array of the configured Engine objects.

consumesource public static

consume( string $var )

Used to read and delete a variable from Configure.

This is primarily used during bootstrapping to move configuration data out of configure into the various other classes in CakePHP.

Parameters

string $var

The key to read and remove.

Returns

array|null
array|null

deletesource public static

delete( string $var )

Used to delete a variable from Configure.

Usage:

Configure::delete('Name'); will delete the entire Configure::Name
Configure::delete('Name.key'); will delete only the Configure::Name[key]

Parameters

string $var

the var to be deleted

Link

http://book.cakephp.org/3.0/en/development/configuration.html#deleting-configuration-data

dropsource public static

drop( string $name )

Remove a configured engine. This will unset the engine and make any future attempts to use it cause an Exception.

Parameters

string $name

Name of the engine to drop.

Returns

boolean
Success

dumpsource public static

dump( string $key , string $config 'default' , array $keys [] )

Dump data currently in Configure into $key. The serialization format is decided by the config engine attached as $config. For example, if the 'default' adapter is a PhpConfig, the generated file will be a PHP configuration file loadable by the PhpConfig.

Usage

Given that the 'default' engine is an instance of PhpConfig. Save all data in Configure to the file my_config.php:

Configure::dump('my_config', 'default');

Save only the error handling configuration:

Configure::dump('error', 'default', ['Error', 'Exception'];

Parameters

string $key

The identifier to create in the config adapter. This could be a filename or a cache key depending on the adapter being used.

string $config optional 'default'

The name of the configured adapter to dump data with.

array $keys optional []

The name of the top-level keys you want to dump. This allows you save only some data stored in Configure.

Returns

boolean
Success

Throws

Cake\Core\Exception\Exception
if the adapter does not implement a dump method.

loadsource public static

load( string $key , string $config 'default' , boolean $merge true )

Loads stored configuration information from a resource. You can add config file resource engines with Configure::config().

Loaded configuration information will be merged with the current runtime configuration. You can load configuration files from plugins by preceding the filename with the plugin name.

Configure::load('Users.user', 'default')

Would load the 'user' config file using the default config engine. You can load app config files by giving the name of the resource you want loaded.

Configure::load('setup', 'default');

If using default config and no engine has been configured for it yet, one will be automatically created using PhpConfig

Parameters

string $key

name of configuration resource to load.

string $config optional 'default'

Name of the configured engine to use to read the resource identified by $key.

boolean $merge optional true

if config files should be merged instead of simply overridden

Returns

boolean
False if file not found, true if load successful.

Link

http://book.cakephp.org/3.0/en/development/configuration.html#reading-and-writing-configuration-files

readsource public static

read( string $var null )

Used to read information stored in Configure. It's not possible to store null values in Configure.

Usage:

Configure::read('Name'); will return all values for Name
Configure::read('Name.key'); will return only the value of Configure::Name[key]

Parameters

string $var optional null

Variable to obtain. Use '.' to access array elements.

Returns

mixed
Value stored in configure, or null.

Link

http://book.cakephp.org/3.0/en/development/configuration.html#reading-configuration-data

readOrFailsource public static

readOrFail( string $var )

Used to get information stored in Configure. It's not possible to store null values in Configure.

Acts as a wrapper around Configure::read() and Configure::check(). The configure key/value pair fetched via this method is expected to exist. In case it does not an exception will be thrown.

Usage:

Configure::readOrFail('Name'); will return all values for Name
Configure::readOrFail('Name.key'); will return only the value of Configure::Name[key]

Parameters

string $var

Variable to obtain. Use '.' to access array elements.

Returns

mixed
Value stored in configure.

Throws

RuntimeException
if the requested configuration is not set.

Link

http://book.cakephp.org/3.0/en/development/configuration.html#reading-configuration-data

restoresource public static

restore( string $name , string $cacheConfig 'default' )

Restores configuration data stored in the Cache into configure. Restored values will overwrite existing ones.

Parameters

string $name

Name of the stored config file to load.

string $cacheConfig optional 'default'

Name of the Cache configuration to read from.

Returns

boolean
Success.

storesource public static

store( string $name , string $cacheConfig 'default' , array $data null )

Used to write runtime configuration into Cache. Stored runtime configuration can be restored using Configure::restore(). These methods can be used to enable configuration managers frontends, or other GUI type interfaces for configuration.

Parameters

string $name

The storage name for the saved configuration.

string $cacheConfig optional 'default'

The cache configuration to save into. Defaults to 'default'

array $data optional null

Either an array of data to store, or leave empty to store all values.

Returns

boolean
Success

versionsource public static

version( )

Used to determine the current version of CakePHP.

Usage

Configure::version();

Returns

string
Current version of CakePHP

writesource public static

write( string|array $config , mixed $value null )

Used to store a dynamic variable in Configure.

Usage:

Configure::write('One.key1', 'value of the Configure::One[key1]');
Configure::write(['One.key1' => 'value of the Configure::One[key1]']);
Configure::write('One', [
    'key1' => 'value of the Configure::One[key1]',
    'key2' => 'value of the Configure::One[key2]'
]);

Configure::write([
    'One.key1' => 'value of the Configure::One[key1]',
    'One.key2' => 'value of the Configure::One[key2]'
]);

Parameters

string|array $config

The key to write, can be a dot notation value. Alternatively can be an array containing key(s) and value(s).

mixed $value optional null

Value to set for var

Returns

boolean
True if write was successful

Link

http://book.cakephp.org/3.0/en/development/configuration.html#writing-configuration-data

[]

null

[
    'debug' => false
]