bitrix-settings

カーネルの設定（.settings.php）

基準：main 23.0+ · 検証済み：main 26.800.0

タスク	参照先
セクション：connections、exception_handling、cookies、crypto、ui、…	rules/sections.md
SMTP によるメール送信（smtp、送信者ごとの SMTP）	rules/smtp.md

読み込まれるファイル

• メイン：/local/.settings.php が存在する場合はそのファイル（main 24.100 以降）、それ以外は /bitrix/.settings.php を読み込みます。読み込まれるのはどちらか一方だけです。/local のファイルはカーネルのファイルを置き換えるため、connections を含むすべてのセクションをコピーしてください。
• 追加：/local/.settings_extra.php があればそのファイル、なければ /bitrix/.settings_extra.php を読み込みます。読み込まれるのはどちらか一方だけです。メインファイルの後に読み込まれ、各トップレベルセクション全体を置き換えます（ディープマージは行われません）。
• プロジェクトのセクション（クロージャー、シークレット、routing、loggers、messenger）は /local/.settings_extra.php に配置してください。このファイルは /bitrix/.settings_extra.php より優先されるため、後者のセクションを移してください。
• カーネルまたは管理画面による書き込み（Configuration::setValue()、設定フォーム）は、メインファイルのデータを var_export でメインファイルに書き込みます。そこにクロージャーを置くと、次回の書き込み時に問題が発生します。追加ファイルは書き換えられません。
• サイトチェッカーと services/quickway.php は /bitrix/.settings.php だけを読み込むため、このファイルを有効な状態に保ってください。IsConfigFile() がファイルマネージャーからのアクセスを拒否するのは /bitrix/.settings.php だけであり、/local/.settings*.php は対象外です。
• php_interface/dbconn.php（/local は main 24.100 以降、それ以外は /bitrix）も引き続き必要です。

形式

'section' => ['value' => [...], 'readonly' => true] — readonly セクションは、実行時の Configuration::add()／delete() と管理画面のフォームでスキップされます。参照するには Configuration::getValue('section') を使用します。

グローバル設定とモジュール設定

ファイル	セクション
グローバルなメイン／追加ファイル	connections、cache、cache_flags、session、cookies、crypto、exception_handling、routing、messenger、loggers、composer、http_client_options、pull、smtp、ui、default_language、services
/local/modules/<id>/.settings.php（モジュールのインストール中に読み込み）	services、controllers、console、messenger、rest（v3）

validation セクションは存在しません（bitrix-validation）。routing はグローバル設定のみです（bitrix-routing）。