Claude Skill

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

LLM Mart · 0 points · 14 views 0 listing impressions 0 install-command copies
Download bxmaximum-bitrix-framework-skills-skills_bitrix-settings-0c65452.zip · 5 KB

Install

skills CLI npx skills add https://github.com/bxmaximum/bitrix-framework-skills/tree/main/skills/bitrix-settings
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install bxmaximum-bitrix-framework-skills@llmmart
Git 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 по-прежнему нужен (/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).

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.

No comments yet.

Reviews (0)

No reviews yet.