Welcome to The Cookbook

write(string $key, mixed $value)

1. write(string $key, mixed $value)

write()を使って、アプリケーションの設定データを保存します。

Configure::write('Company.name','株式会社ピザ');
Configure::write('Company.slogan','体と心にピザを');

1. Configure::write('Company.name','株式会社ピザ');
2. Configure::write('Company.slogan','体と心にピザを');

$keyのパラメータとして、ドットを使っていることに注意してください。このドットを使って、論理グループごとに設定を整理することができます。

Configure::write(
    'Company',array('name'=>'株式会社ピザ','slogan'=>'体と心にピザを')
);

1. Configure::write(
2. 'Company',array('name'=>'株式会社ピザ','slogan'=>'体と心にピザを')
3. );

Configure::write(‘debug’, $int)を使って、デバッグと運用モードをすぐに切り替えることができます。AMFやSOAPなどとの連携の際、デバッグ情報のためにパースに問題が生じるような場合に特に便利に使うことができます。

read(string $key = 'debug')

1. read(string $key = 'debug')

アプリケーションから、環境設定データを読み込むために使います。デフォルトでは、CakePHPの重要なデバッグ値が設定されています。keyが指定されると、そのデータが返されます。上のwrite()の例を使うと、返される次のようなデータを取得できます。

Configure::read('Company.name');    //出力は: '株式会社ピザ'
Configure::read('Company.slogan');  //出力は: '体と心にピザを'
 
Configure::read('Company');
 
//出力は: 
array('name' => '株式会社ピザ', 'slogan' => '体と心にピザを');

1. Configure::read('Company.name'); //出力は: '株式会社ピザ'
2. Configure::read('Company.slogan'); //出力は: '体と心にピザを'
4. Configure::read('Company');
6. //出力は:
7. array('name' => '株式会社ピザ', 'slogan' => '体と心にピザを');

delete(string $key)

1. delete(string $key)

アプリケーションの環境設定から情報を削除するのに使います。

Configure::delete('Company.name');

1. Configure::delete('Company.name');

load(string $path)

1. load(string $path)

指定したファイルから環境設定をloadするためにこのメソッドを使ってください。

// /app/config/messages.php:
<?php
$config['Company']['name'] = '株式会社ピザ';
$config['Company']['slogan'] = '体と心にピザを';
$config['Company']['phone'] = '555-55-55';
?>
 
<?php
Configure::load('messages');
Configure::read('Company.name');
?>

1. // /app/config/messages.php:
2. <?php
3. $config['Company']['name'] = '株式会社ピザ';
4. $config['Company']['slogan'] = '体と心にピザを';
5. $config['Company']['phone'] = '555-55-55';
6. ?>
8. <?php
9. Configure::load('messages');
10. Configure::read('Company.name');
11. ?>

ファイルの中では、$config配列のキーと配列のペアで設定されていることに注意してください。ファイル内のその他の変数は、load()では無視されます。

version()

1. version()

現在のアプリケーションのCakePHPのバージョンを返します。

The Configure class is used to manage a set of core CakePHP configuration variables. These variables can be found in app/config/core.php. Below is a description of each variable, and how it’s usage affects your CakePHP application.

Note: Cache configuration is also found in core.php — We’ll be covering that later on, so stay tuned.

The Configure class can be used to read and write core configuration settings on the fly. This can be especially handy if you want to turn the debug setting on for a limited section of logic in your application, for instance.

While most configuration options are handled by Configure, there are a few constants that CakePHP uses during runtime.