構成設定¶

追加の設定ファイルの読み込み¶

もしアプリケーションに多くの設定オプションがあるとき、設定を複数のファイルに分けることで役に立ちます。 config/ ディレクトリーに複数ファイルを作成したのち、 bootstrap.php でそれらを読み込めます。

use Cake\Core\Configure;
use Cake\Core\Configure\Engine\PhpConfig;

Configure::config('default', new PhpConfig());
Configure::load('app', 'default', false);
Configure::load('other_config', 'default');

追加の設定ファイルを使用して、環境特有の設定に上書きすることもできます。各ファイルを app.php の後で読み込むことで、開発環境やステージング環境の設定をカスタマイズするために 以前に宣言した変数を再定義できます。

一般的な設定¶

以下は、変数の説明と CakePHP アプリケーションに与える影響です。

debug

CakePHP のデバッグ出力を制御します。 false = 本番モードです。 エラーメッセージやエラー、ワーニング出力を行いません。 true = エラーとワーニングが出力されます。

App.namespace

app クラスを見つけるための名前空間。

注釈

名前空間の設定を変更した時は、おそらく composer.json ファイルもまた、 この名前空間を利用するように更新する必要があります。加えて、 php composer.phar dumpautoload を実行して、新しいオートローダーを作成してください。

App.baseUrl

もし CakePHP で Apache の mod_rewrite を利用する 予定がない 場合、 この定義のコメントを解除してください。 .htaccess ファイルを取り除くことを忘れないでください。

App.base

アプリの存在するベースディレクトリーです。もし false をセットしたら、自動で検出されます。 false 以外の場合、書き出しは / から始め、 / で終わらないことを確認してください。 例えば、 /basedir は有効な App.base です。さもなければ、 AuthComponent は適切に動かなくなります。

App.encoding

あなたのアプリケーションで使用するエンコードを指定します。 このエンコーディングはレイアウトの charset の生成やエンティティーのエンコードに利用されます。 それは、データベースのエンコードの値と合うように指定すべきです。

App.webroot

webroot のディレクトリーです。

App.wwwRoot

webroot のファイルパスです。

App.fullBaseUrl

アプリケーションのルートまでの (プロトコルを含む) 完全修飾ドメイン名です。 これは完全な URL を生成する際に利用されます。デフォルトでは、この値は $_SERVER の環境情報から生成されます。しかし、パフォーマンスを最適化したり、 他人が Host ヘッダーを操作するのを心配するならば、自分で指定すべきでしょう。 CLI 環境 (シェル) ではウェブサーバーとの関連が無いので fullBaseUrl を $_SERVER から読むことができません。もしシェルから URL を作成する必要がある場合 (例えばメールの送信) 、自力で指定する必要があります。

App.imageBaseUrl

webroot 以下の公開画像ディレクトリーのパスになります。 もし CDN を利用している場合、CDN の場所をセットすべきです。

App.cssBaseUrl

webroot 以下の公開 css ディレクトリーのパスになります。 もし CDN を利用している場合、CDN の場所をセットすべきです。

App.jsBaseUrl

webroot 以下の公開 js ディレクトリーのパスになります。 もし CDN を利用している場合、CDN の場所をセットすべきです。

App.paths

クラスベースではないリソースの Configure のパスです。 plugins 、 templates 、 locales などのサブキーをサポートし、 それぞれプラグイン、ビューテンプレート、ロケールファイルのパスを指定できます。

Security.salt

ハッシュ化の時に利用されるランダムな文字列です。 この値は 対称キー暗号化の際、HMAC ソルトとして利用されます。

Asset.timestamp

適切なヘルパーを使用した際、アセットファイルの URL (CSS, JavaScript, Image) の終端に そのファイルの最終更新時間のタイムスタンプを加えます。 有効な値:

• (bool) false - 何もしません (デフォルト)。

• (bool) true - debug が true の時にタイムスタンプを加えます。

• (string) 'force' - 常にタイムスタンプを加えます。

バージョン 3.6.0 で変更: 3.6.0 以降、アセットのリンク時に timestamp オプションを使用することで、 グローバルな設定を上書きできます。

Asset.cacheTime

アセットのキャッシュ時間を設定します。 アセットのための HTTP ヘッダー Cache-Control の max-age と HTTP ヘッダーの Expire の時間を決定します。 php の strtotime 関数 の書式を設定できます。デフォルトは +1 day です。

データベースの設定¶

データベース接続の設定は データベース設定 を参照してください。

キャッシュの設定¶

CakePHP のキャッシュ設定は キャッシュ設定 を参照してください。

エラーと例外ハンドリング設定¶

エラーの設定と例外のハンドリングは エラーと例外設定 を参照してください。

ログの設定¶

CakePHP のログの設定は ロギング設定 を参照してください。

メールの設定¶

CakePHP のメールプリセットの設定は メールの設定 を参照してください。

セッションの設定¶

CakePHP のセッション操作の設定は セッションの設定 を参照してください。

ルーティングの設定¶

ルーティングの設定やアプリケーションのルートの作成に関する詳しい情報は ルーティングの設定 を参照してください。

プラグイン、ビュー、テンプレート、ロケールのパス¶

プラグイン、ビューテンプレート、そしてロケールはクラスではないので、オートローダーの設定はありません。 CakePHP はこれらのリソースの追加パスをセットアップするための 3 つの Configure 変数を提供します。 config/app.php の中でこれらの変数をセットできます。

return [
    // 他の設定
    'App' => [
        'paths' => [
            'plugins' => [
                ROOT . DS . 'plugins' . DS,
                '/path/to/other/plugins/'
            ],
            'templates' => [
                APP . 'Template' . DS,
                APP . 'Template2' . DS
            ],
            'locales' => [
                APP . 'Locale' . DS
            ]
        ]
    ]
];

パスはディレクトリーセパレーター付きで終了し、そうでないと適切に動作しないです。

設定データの書き込み¶

static Cake\Core\Configure::write($key, $value)¶

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

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

上記の例は一度の呼び出しでも記述できます。

Configure::write('Company', [
    'name' => 'Pizza, Inc.',
    'slogan' => 'Pizza for your body and soul'
]);

Configure::write('debug', $bool) を利用してデバッグと本番モードを即時に変更できます。 これはとりわけ JSON のやりとりで使いやすく、デバッグ情報がパースの問題を引き起こす際です。

設定データの読み込み¶

static Cake\Core\Configure::read($key = null, $default = null)¶

アプリケーションから設定データを読み込むために利用されます。もしキーが指定されれば、 そのデータが返却されます。上記の write() の例を取り上げると、以下のようにデータを読み込みます。

// 'Pizza Inc.' を返します
Configure::read('Company.name');

// 'Pizza for your body and soul' を返します
Configure::read('Company.slogan');

Configure::read('Company');
// 戻り値:
['name' => 'Pizza, Inc.', 'slogan' => 'Pizza for your body and soul'];

// Company.nope は定義されていないので 'fallback' を返します
Configure::read('Company.nope', 'fallback');

もし $key が null のままだと、Configure のすべての値が返却されます。

static Cake\Core\Configure::readOrFail($key)¶

設定データを単に Cake\Core\Configure::read で読み込みますが、 一方で key/value ペアを検索することを期待します。要求されたペアが存在しない場合、 RuntimeException が投げられます。

Configure::readOrFail('Company.name');    // 出力: 'Pizza, Inc.'
Configure::readOrFail('Company.geolocation');  // 例外を投げる

Configure::readOrFail('Company');

// 出力:
['name' => 'Pizza, Inc.', 'slogan' => 'Pizza for your body and soul'];

定義されている設定データのチェック¶

static Cake\Core\Configure::check($key)¶

キー / パス が存在しているか、値が null でないかチェックする場合に利用します。

$exists = Configure::check('Company.name');

設定データの削除¶

static Cake\Core\Configure::delete($key)¶

アプリケーションの設定から情報を削除するために利用されます。

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

設定データの読み書き¶

static Cake\Core\Configure::consume($key)¶

Configure からキーの読み込みと削除を行います。 もしあなたが値の読み込みと削除を単一の動作で組み合わせたい時に便利です。

static Cake\Core\Configure::consumeOrFail($key)¶

Cake\Core\Configure::consume のように設定データを消費しますが、 一方でキーと値のペアが見つかることを期待します。要求されたペアが存在しない場合、 RuntimeException が投げられます。

Configure::consumeOrFail('Company.name');    // 出力: 'Pizza, Inc.'
Configure::consumeOrFail('Company.geolocation');  // 例外を投げる

Configure::consumeOrFail('Company');

// 出力:
['name' => 'Pizza, Inc.', 'slogan' => 'Pizza for your body and soul'];

設定ファイルの読み込み¶

static Cake\Core\Configure::load($key, $config = 'default', $merge = true)¶

一旦設定エンジンに Configure を設定すると、設定ファイルを読み込むことができます。

// 'default' エンジンオブジェクトを使用して my_file.php を読み込む
Configure::load('my_file', 'default');

読み込まれた設定ファイルは、自身のデータを Configure 内に存在している実行時の設定とマージします。 これは存在している実行時の設定へ値の上書きや新規追加を可能とします。 $merge を true にセットすることで、存在している設定の値を上書きしなくなります。

設定ファイルの作成や編集¶

static Cake\Core\Configure::dump($key, $config = 'default', $keys = [])¶

全て、もしくはいくつかの Configure にあるデータを、 ファイルや設定エンジンがサポートしているストレージシステムにダンプします。 シリアライズのフォーマットは、$config で配置された設定エンジンから決定されます。 例えば、もし 'default' エンジンが Cake\Core\Configure\Engine\PhpConfig ならば、生成されたファイルは Cake\Core\Configure\Engine\PhpConfig によって読み込み可能な PHP の設定ファイルになるでしょう。

'default' エンジンは PhpConfig のインスタンスとして考えられます。 Configure の全てのデータを my_config.php に保存します。

Configure::dump('my_config', 'default');

エラーハンドリング設定のみ保存します。

Configure::dump('error', 'default', ['Error', 'Exception']);

Configure::dump() は Configure::load() で読み込み可能な設定ファイルを 変更もしくは上書きするために利用できます。

実行時の設定を保存¶

static Cake\Core\Configure::store($name, $cacheConfig = 'default', $data = null)¶

将来のリクエストのために、実行時の設定を保存することができます。 設定は現在のリクエストのみ値を記憶するので、 もしその後のリクエストで編集された設定情報を利用したければ、それを保存する必要があります。

// 現在の設定を 'user_1234' キーに 'default' キャッシュとして保存
Configure::store('user_1234', 'default');

保存された設定データはその名前のキャッシュ設定で存続します。 キャッシュに関するより詳しい情報は キャッシュ を参照してください。

実行時の設定を復元¶

static Cake\Core\Configure::restore($name, $cacheConfig = 'default')¶

実行時の設定を保存すると、おそらくそれを復元して、再びそれにアクセスする必要があります。 Configure::restore() がちょうどそれに該当します。

// キャッシュから実行時の設定を復元する
Configure::restore('user_1234', 'default');

設定情報を復元する場合、それを保存する時に使われたのと同じ鍵、 およびキャッシュ設定で復元することが重要です。 復元された情報は、既存の実行時設定の最上位にマージされます。

設定エンジン¶

CakePHP は、さまざまなソースから設定ファイルを読み込む機能を提供し、 独自の設定エンジンを作成するための プラガブルなシステムを備えています。組み込みの設定エンジンは次の通りです。

• JsonConfig

• IniConfig

• PhpConfig

デフォルトでは、アプリケーションは PhpConfig を使用します。

Application::bootstrap()¶

アプリケーションの低レベルな関心事を設定するために使用する config/bootstrap.php ファイルに加えて、 プラグインのロードや初期化、グローバルイベントリスナーの追加のために Application::bootstrap() フックメソッドが利用できます。

// src/Application.php の中で
namespace App;

use Cake\Core\Plugin;
use Cake\Http\BaseApplication;

class Application extends BaseApplication
{
    public function bootstrap()
    {
        // config/bootstrap.php を `require_once`  するために parent を呼びます。
        parent::bootstrap();

        $this->addPlugin('MyPlugin', ['bootstrap' => true, 'routes' => true]);
    }
}

Application::bootstrap() の中でプラグインやイベントを読み込むと、各テストメソッドで イベントやルートが再処理されるため コントローラーの統合テスト が簡単になります。