bitrix-settings
Covers kernel configuration — .settings.php sections (connections, cache, session, crypto, exception_handling, routing, messenger, pull, smtp, loggers, composer), .settings_extra.php, readonly flag. Applied when configuring kernel behavior. Key terms — .settings.php, settings, re
Install
npx skills add https://github.com/bxmaximum/bitrix-framework-skills/tree/main/skills/bitrix-settings
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install bxmaximum-bitrix-framework-skills@llmmart
git clone https://github.com/bxmaximum/bitrix-framework-skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole bxmaximum/bitrix-framework-skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Конфигурация ядра (.settings.php)
Baseline: main 23.0+ · Verified: main 26.1000.0
Перед PHP-кодом прочитай bitrix-framework, если ещё не читал его в этой задаче.
В таблице выбери только нужный rules/*.md; пути относительны каталогу скилла.
| Задача | Читать |
|---|---|
Секции connections, exception_handling, cookies, crypto, ui и другие |
rules/sections.md |
Почта через SMTP (smtp, подключения отправителей) |
rules/smtp.md |
Какой файл читается
- Основной:
/local/.settings.php, если есть (Since main 24.100), иначе/bitrix/.settings.php. Читается один. Файл/localзаменяет ядерный: перенеси все секции, включаяconnections. - Дополнительный:
/local/.settings_extra.php, иначе/bitrix/.settings_extra.php. Читается один после основного; каждая секция верхнего уровня заменяется целиком, без глубокого слияния. - Секции проекта помещай в
/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по-прежнему нужен (/localSince 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).
Files (bitrix-framework-skills)
-
rules
-
sections.md 4.6 KB
Loading… -
smtp.md 2.6 KB
Loading…
-
-
SKILL.md 3.3 KB
--- name: bitrix-settings description: 'Используй для конфигурации ядра Битрикса: .settings.php и .settings_extra.php, Configuration, приоритет /local, секции и readonly. Глобальные и модульные настройки.' --- # Конфигурация ядра (`.settings.php`) Baseline: main 23.0+ · Verified: main 26.1000.0 Перед PHP-кодом прочитай `bitrix-framework`, если ещё не читал его в этой задаче. В таблице выбери только нужный `rules/*.md`; пути относительны каталогу скилла. | Задача | Читать | | --- | --- | | Секции `connections`, `exception_handling`, `cookies`, `crypto`, `ui` и другие | `rules/sections.md` | | Почта через SMTP (`smtp`, подключения отправителей) | `rules/smtp.md` | ## Какой файл читается - Основной: `/local/.settings.php`, если есть (**Since main 24.100**), иначе `/bitrix/.settings.php`. Читается один. Файл `/local` **заменяет** ядерный: перенеси все секции, включая `connections`. - Дополнительный: `/local/.settings_extra.php`, иначе `/bitrix/.settings_extra.php`. Читается один после основного; каждая секция верхнего уровня заменяется целиком, без глубокого слияния. - Секции проекта помещай в `/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` **Since 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`).
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.