Welcome to The Cookbook

Use write() to store data in the application’s configuration.

<?php
 
Configure::write('Company.name','Pizza, Inc.');
Configure::write('Company.slogan','Pizza for your body and soul');
 
?>

1. <?php
3. Configure::write('Company.name','Pizza, Inc.');
4. Configure::write('Company.slogan','Pizza for your body and soul');
6. ?>

Note the usage of dot notation in the $key parameter. You can use this notation to organize your configuration into logical groups.

The above example could also be written in a single call:

<?php
 
Configure::write(
    'Company',array('name'=>'Pizza, Inc.','slogan'=>'Pizza for your body and soul')
);
 
?>

1. <?php
3. Configure::write(
4. 'Company',array('name'=>'Pizza, Inc.','slogan'=>'Pizza for your body and soul')
5. );
7. ?>

You can use Configure::write(‘debug’, $int) to switch between debug and production modes on the fly. This is especially handy for AMF or SOAP interactions where debugging information can cause parsing problems.

Used to read configuration data from the application. Defaults to CakePHP’s important debug value. If a key is supplied, the data is returned. Using our examples from write() above, we can read that data back:

<?php
 
Configure::read(‘Company.name’);    //yields: ‘Pizza, Inc.’
Configure::read(‘Company.slogan’);  //yields: ‘Pizza for your body and soul’
 
Configure::read(‘Company’);
 
//yields:
 
array(‘name’ => ‘Pizza, Inc.’, ‘slogan’ => ‘Pizza for your body and soul’);
 
?>

1. <?php
3. Configure::read(‘Company.name’); //yields: ‘Pizza, Inc.’
4. Configure::read(‘Company.slogan’); //yields: ‘Pizza for your body and soul’
6. Configure::read(‘Company’);
8. //yields:
10. array(‘name’ => ‘Pizza, Inc.’, ‘slogan’ => ‘Pizza for your body and soul’);
12. ?>

Used to delete information from the application’s configuration.

<?php Configure::delete('Company.name'); ?>

1. <?php Configure::delete('Company.name'); ?>

Use this method to load configuration information from a specific file.

/app/config/messages.php:
 
<?php
$config['Company’][‘name'] = 'Pizza, Inc.';
$config['Company’][‘slogan'] = 'Pizza for your body and soul';
$config['Company’][‘phone'] = '555-55-55';
?>
 
<?php
Configure::load(‘messages’);
Configure::read(‘Company.name’);
?>

1. /app/config/messages.php:
3. <?php
4. $config['Company’][‘name'] = 'Pizza, Inc.';
5. $config['Company’][‘slogan'] = 'Pizza for your body and soul';
6. $config['Company’][‘phone'] = '555-55-55';
7. ?>
9. <?php
10. Configure::load(‘messages’);
11. Configure::read(‘Company.name’);
12. ?>

Note that every configure key-value pair is represented in the file with the $configure array. Any other variables in the file will be ignored by the load() function.

Returns the CakePHP version for the current application.