設定ファイルの原則

symfony の設定ファイルは一連の共通原則にしたがって共通のプロパティを共有します。ほかの章のガイダンスとして、この章では共通原則をくわしく説明します。

キャッシュ

すべての設定ファイルのキャッシュはコンフィギュレーションハンドラクラスによって PHP ファイルとして保存されます。is_debug 設定に false がセットされている場合 (たとえば prod 環境)、YAML ファイルがアクセスされるのは初回リクエストのときにかぎられます。次回以降のリクエストではキャッシュとして保存された PHP ファイルが使われます。このような仕様が意味するのは、YAML ファイルのパースと解釈が実行されるのは初回リクエストにかぎられるので、「重い」処理は1回だけですむということです。

config_handler.yml ファイルで指定されている特別なコンフィギュレーションハンドラクラスがそれぞれの設定ファイルのパースとキャッシュを担当します。

次の節で「コンパイル」について説明します。コンパイルされるとは、初回アクセスのときに、YAML ファイルが PHP ファイルに変換され、キャッシュに保存されることを意味します。

$ php symfony cache:clear --type=config

定数

設定ファイル: core_compile.yml、factories.yml、generator.yml、databases.yml、 filters.yml、view.yml、autoload.yml

設定ファイルのなかにはあらかじめ定義されている定数の使用を許可しているものがあります。定数の宣言は %XXX% プレースホルダ (XXX は大文字のキー) であらわされ、「コンパイル」のときに実際の値に置き換わります。

コンフィギュレーションの設定項目

settings.yml ファイルで定義されている任意の設定に定数を投入することができます。プレースホルダのキーは SF_ をプレフィックスとする大文字の設定キーの名前です。

logging: %SF_LOGGING_ENABLED%

symfony が設定ファイルをコンパイルするとき、既存のすべての %SF_XXX% プレースホルダは settings.yml ファイルからの値に置き換わります。上記の例では、SF_LOGGING_ENABLED プレースホルダは settings.yml ファイルで定義されている logging_enabled 設定の値に置き換わります。

アプリケーションの設定項目

app.yml ファイルで定義されている設定にアクセスするには、キーの名前にプレフィックスの APP_ をつけた文字列を使います。

特別な定数

デフォルトでは、現在のフロントコントローラに対して4つの定数が定義されています。

ディレクトリ

ディレクトリもしくはファイルパスを参照するとき、ハードコーディングよりも定数のほうがはるかに便利です。共通のプロジェクトとアプリケーションディレクトリのためにさまざまな定数が定義されています。

階層の基点となるプロジェクトのルートディレクトリをあらわす定数は SF_ROOT_DIR です。ほかのすべての定数はこのルートディレクトリから派生します。

プロジェクトのディレクトリ構造は次のように定義されています。

アプリケーションのディレクトリ構造は SF_APPS_DIR/APP_NAME ディレクトリの下で定義されています。

最後に、アプリケーションキャッシュのディレクトリ構造は次のように定義されています。

環境の認識

設定ファイル: settings.yml、factories.yml、databases.yml、app.yml

設定ファイルのなかには環境を認識するものがあり、これらの環境認識は symfony のプロジェクトがホストされているサーバーの環境にもとづいています。これらの設定ファイルには、環境ごとに専用のセクションが設けられており、環境ごとに異なるコンフィギュレーションを定義できます。作られた直後のアプリケーションでは、3つのデフォルト環境 (prod、test と dev) を含む設定ファイルが用意されています。

prod:
  # prod 環境のコンフィギュレーション
 
test:
  # test 環境のコンフィギュレーション
 
dev:
  # dev 環境のコンフィギュレーション
 
all:
  # すべての環境のデフォルトコンフィギュレーション

symfony が設定ファイルからの値を必要とするとき、現在の環境セクションで見つかるコンフィギュレーションと all セクションのコンフィギュレーションがマージされます。all セクションは特殊なセクションで、すべての環境のデフォルトコンフィギュレーションが定義されています。環境セクションが定義されていなければ、all コンフィギュレーションが代わりに使われます。

コンフィギュレーションカスケード

設定ファイル: core_compile.yml、autoload.yml、settings.yml、 factories.yml、databases.yml、security.yml、cache.yml、 app.yml、filters.yml、view.yml

symfony のプロジェクトディレクトリには複数の config/ サブディレクトリが収められており、設定ファイルを配置することができます。

コンフィギュレーションがコンパイルされるとき、すべての異なるファイルからの値は次の優先順位にしたがってマージされます。

• モジュールのコンフィギュレーション (PROJECT_ROOT_DIR/apps/APP_NAME/modules/MODULE_NAME/config/XXX.yml)
• アプリケーションのコンフィギュレーション (PROJECT_ROOT_DIR/apps/APP_NAME/config/XXX.yml)
• プロジェクトのコンフィギュレーション (PROJECT_ROOT_DIR/config/XXX.yml)
• プラグインで定義されているコンフィギュレーション (PROJECT_ROOT_DIR/plugins/*/config/XXX.yml)
• symfony のライブラリで定義されているデフォルトコンフィギュレーション (SF_LIB_DIR/config/XXX.yml)

たとえば、アプリケーションディレクトリに配置されている settings.yml ファイルが継承するのは、プロジェクトの config/ ディレクトリに収められている一連のメインコンフィギュレーション、およびフレームワーク自身に収められているデフォルトコンフィギュレーションです (lib/config/config/settings.yml)。