Configuration Split

概要

Features

• 完全分割：設定を完全にsplitストレージに移動し、エクスポート時にメインのsyncディレクトリから削除
• 部分分割：設定をsyncディレクトリに残しつつ、差分のみをパッチとしてsplitストレージに保存
• 複数のストレージバックエンド：splitした設定をファイルシステムフォルダ、configコレクション、またはデータベーステーブルに保存
• 環境固有の有効化：settings.phpのオーバーライドまたはDrupal stateで分割を有効化・無効化し、環境ごとの制御が可能
• モジュールフィルタリング：指定したモジュールに関連するすべての設定を依存設定も含めて自動的に分割
• テーマフィルタリング：テーマ固有の設定を分割（現在は限定的なサポート）
• ワイルドカードサポート：ワイルドカード（例：views.view.*）を使用して複数の設定項目をマッチングして分割
• スタック可能な分割：高いweightの分割が低いweightの分割からの設定を変更できる、レイヤー化された分割を作成
• 設定パッチ：モジュールが分割された際に依存設定を自動的に更新
• Drush統合：エクスポート、インポート、有効化、無効化、ステータスオーバーライド操作の完全なコマンドラインサポート
• UIベースの管理：プレビュー機能付きで分割の作成、編集、管理ができるWebインターフェース
• 差分表示：インポート前にアクティブな設定と分割設定の差分を表示
• config_readonlyとの統合：config_readonlyモジュール用にデータベース分割エントリを自動的にホワイトリストに追加

Use Cases

Tips

• 常にsyncディレクトリの外部のフォルダパスを使用してください。ネストされたディレクトリはconfig sync時にコンフリクトを引き起こします。
• 分割をconfigエクスポート・アーカイブに含める場合（例：配布用）は、コレクションストレージを使用してください。
• 環境間で共有されるべきでないローカル専用の設定には、データベースストレージを使用してください。
• 予測可能な順序付けのために、settings.phpで分割の優先度を設定してください：$settings['config_split_priorities'] = ['production' => 100, 'development' => -100];
• complete/partial listでワイルドカードを使用して柔軟なマッチングを行ってください：views.view.*、system.*、block.block.bartik_*
• 「ローカルのみ有効化」オプションは、共有設定に影響を与えずに分割をテストするのに便利です。
• stackable分割を使用する場合、高いweightの分割が低いweightの分割のエクスポート内容を変更できることを覚えておいてください。
• 各分割のビューページを確認して、プレビュー（エクスポートされる内容）とエクスポート済み（現在保存されている内容）を確認してください。
• CI/CDパイプラインでは、drush cexの後にdrush config-split:exportを使用するか、自動的に実行されるpost-commandフックに依存してください。
• 部分分割は、syncに存在すべきだが環境固有の値（APIエンドポイントなど）が必要な設定に最適です。