設定ファイルの原則

symfonyの設定ファイルは一連の共通原則にしたがい共通のプロパティを共有します。 このセクションでは、YAMLの設定ファイルを説明するほかのセクション用のリファレンスとしてこれらを詳しく説明します。

キャッシュ

symfonyのすべての設定ファイルはコンフィギュレーションハンドラークラスによってPHPファイルとしてキャッシュされます。 is_debug設定がfalseのとき(たとえばprod環境)、YAMLファイルは初回のリクエスト時のみ アクセスされます;初回以降のアクセスはPHPキャッシュが使われます。 前述のような仕様は初回時のみYAMLファイルの解析と解釈を行うことで、"重い"作業は一度しか行われないことを意味します。

それぞれの設定ファイルの解析とキャッシュは特別なコンフィギュレーションハンドラークラスで行われます。 コンフィギュレーションハンドラーは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_をつけることでapp.yml設定ファイルで定義される設定も使うことができます。

特別な定数

デフォルトでは、現在のフロントコントローラーに従ってsymfonyは4つの定数を定義します:

ディレクトリ

ハードコードせずにディレクトリもしくはファイルパスを参照する際に定数はとても便利です。 symfonyは共通のプロジェクトとアプリケーションディレクトリ用に多くの定数を定義します。

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

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

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

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

環境の認識

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

symfonyの設定ファイルのなかには環境を認識するものがあります。 環境の解釈は現在symfonyが動作している環境に依存します。 これら設定ファイルはそれぞれの環境ごとに変化するべき設定を定義するための異なるセクションを持ちます。 新しいアプリケーションを作成するとき、symfonyは3つのデフォルト環境: prod、testとdevを含む適切な設定ファイルを作成します:

prod:
  # prod環境用の設定
 
test:
  # test環境用の設定
 
dev:
  # dev環境用の設定
 
all:
  # すべての環境用のデフォルト設定

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

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

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

設定ファイルはプロジェクトのディレクトリ構造に格納されるいくつかの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)を継承します。