Welcome to The Cookbook

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')

アプリケーションから、環境設定データを読み込むために使います。デフォルトでは、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)

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

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

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

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()

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