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のバージョンを返します。

Configureクラスは、CakePHPの一連の環境設定変数を管理するために使用されます。これらの変数は、app/config/core.phpの中にあります。下記では、各変数の詳細とCakePHPアプリケーションにどのように影響するかを説明します。

キャッシュの設定は、core.php にもあります。この点については後の章にもありますので参考にしてください。

Configureクラスは、サイトの動作中に、コアの環境設定を読み書きすることができます。たとえば、アプリケーションの中で、ある特定の部分だけデバッグ設定を変えたいというような場合などに特に便利です。

ほとんどの環境設定はConfigureで行いますが、CakePHPが実行時に使用する定数がほかにもあります。