CakePHP3のConfigureクラスに関して調べました

こんばんは。ファガイです。
本日は、CakePHP3のConfigureクラスに関して調べました。

使用環境

基本的にConfigureクラスの動作を確認するのはconfig/bootstrap.phpで行いました。ちょうど、try-catchで書かれている箇所があるため、ここを参考にしました。

また、マニュアルを見ていただくと詳しく載ってるので、そちらを確認するとよいでしょう。
Configuration — CakePHP Cookbook 3.x documentation

2系では、PhpReaderだったのが、3系では、PhpConfigに変更されてたりします。
現状でRC1に搭載されているのは以下です。

ほかに、予定されている物は以下となります。

途中までCakePHP2と違うのかなって思って書いてたのですが、ほとんど一緒ですね・・・。

Configに使用するConfigEngineを定義します。(bootstrapには現在PhpConfigのみ登録されています。

use Cake\Core\Configure\Engine\PhpConfig;

// Configエンジン名をdefaultとしてPhpConfigエンジンを定義(エイリアスっぽいの
Configure::config('default', new PhpConfig());

このConfigEngineは他のエンジンや、自分で作ったエンジンも利用可能です。一度PhpConfigのソースを見てみると良いでしょう。

Engineのセットが完了したら、ファイルをロードしましょう。

// config/app.phpを読み込む。使用するエンジンはdefault。マージしない
Configure::load('app', 'default', false);

一応コメントに書いていますが、おそらくよく分からなくなるのはマージの部分でしょう。
マージはfalseの場合、上書きとなります。少し、説明が必要かもしれません。

[
    'item' => array(
        'id' => 1,
        'name' => 'Cake'
    )
]

と

[
    'item' => array(
        'id' => 2
    )
]

があったとして、前者を先にロードしておいて、後者をマージしないにすると、

[
    'item' => array(
        'id' => 2
    )
]

となります。逆に、マージするにすると、

[
    'item' => array(
        'id' => 2,
        'name' => 'Cake'
    )
]

となります。

また、読み込むエンジンが別だとしても、データは同じ場所に格納されるようになっています。

ちょっと余談にはなりますが、おそらくPhpConfigの形式は次のバージョンから変わると思います。

まあ、変わる内容っていうのは単純に変数として持つのではなくて、戻り値として渡す形になると思われます。(devバージョンを見る感じ)

今は以下の様にconfigを書きますが

$config = [];

いずれこの形になるでしょう。

return [];

// Appキーの中にあるencodingキーを取得する
Configure::read('App.encoding');

Configure::check('App.encoding');

Configure::delete('App.encoding');

Configure::consume('test');

Configure::drop('default');

Configureクラスはいつもどおりでした・・・ｗ
まあ、知らない内容も知れたのでよかったです～。

ではではー。