Claude Skill

bitrix-performance

Covers Bitrix performance — composite site, query optimization, replication/clustering, sharding, hot/cold sessions. Applied for high-load optimization beyond basic caching. Key terms — composite, NGINX, replication, sharding, query optimization.

LLM Mart · 0 points · 15 views 2 listing impressions 0 install-command copies
Download bxmaximum-bitrix-framework-skills-skills_bitrix-performance-0c65452.zip · 2 KB

Install

skills CLI npx skills add https://github.com/bxmaximum/bitrix-framework-skills/tree/main/skills/bitrix-performance
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

Производительность

Baseline: main 23.0+ · Verified: main 26.1000.0

Перед PHP-кодом прочитай bitrix-framework, если ещё не читал его в этой задаче.

Кеширование: bitrix-caching. Профилирование SQL: bitrix-database (SqlTracker). Сессии: bitrix-sessions.

Композит

Статический HTML берётся из композитного кеша, в том числе напрямую через NGINX; динамические области загружаются следующим запросом. Включение: Настройки → Композитный сайт. Ядро: Bitrix\Main\Composite\Engine, Page, StaticArea, BufferArea.

В шаблоне компонента ($this — CBitrixComponentTemplate):

$this->setFrameMode(true);                 // шаблон совместим с композитом

$frame = $this->createFrame()->begin('Загрузка…');  // заглушка в кешированном HTML
echo htmlspecialcharsbx($arResult['USER_NAME']);   // динамическое содержимое
$frame->end();

Объёмная заглушка: begin() → динамическое содержимое → beginStub() → HTML заглушки → end().

Вне компонентов (шапка шаблона сайта, функции в init.php):

use Bitrix\Main\Composite\StaticArea;

$area = new StaticArea('vendor_cart_counter');
$area->setStub('<span>0</span>');
$area->startDynamicArea();
echo (int)$basketCount;
$area->finishDynamicArea();
  • Настройка компонента без кода: параметры COMPOSITE_FRAME_MODE (A/Y/N) и COMPOSITE_FRAME_TYPE (AUTO, STATIC, DYNAMIC_WITH_STUB, DYNAMIC_WITHOUT_STUB).
  • Исключить страницу: \Bitrix\Main\Composite\Page::getInstance()->markNonCacheable().
  • Атрибута data-dynamic и свойства страницы composite_frame_mode нет.
  • Не оставляй личные данные (имя, корзину, права, CSRF-токены) в статической части. Проверь динамические области гостем и авторизованным пользователем.

Запросы

  • Выбирай нужные поля; индексируй столбцы filter/order.
  • Устраняй N+1: fetchCollection() + fill() либо связи в select (bitrix-orm).
  • Используй пакетную запись (addMulti, updateMulti) вместо записи по строке в цикле.
  • Повторные чтения: кеш ORM-запроса; собранные результаты: тегированный кеш данных.

Реплики чтения

С модулем cluster запросы SELECT через query() могут уходить на реплику. Чтение сразу после записи закрепляй за основной БД:

$pool = \Bitrix\Main\Application::getInstance()->getConnectionPool();
$pool->useMasterOnly(true);
try
{
    $row = OrderTable::getById($id)->fetch();
}
finally
{
    $pool->useMasterOnly(false);
}

useMasterOnly() меняет счётчик вложенности: каждому true нужен false в finally.

Дополнительные БД для аналитики и отчётов: именованное подключение в connections (bitrix-database).

Проверка

  • Динамические области композита проверены гостем и авторизованным пользователем.
  • Если настроена отдача композита через NGINX, проверено попадание в статический кеш.
  • Медленные запросы найдены через SqlTracker, нужные индексы созданы.
Files (bitrix-framework-skills)
  • SKILL.md 4.3 KB
    ---
    name: bitrix-performance
    description: 'Производительность Битрикс: композит (createFrame, StaticArea), динамические области и реплики чтения модуля cluster. Используй при медленных страницах и запросах или настройке композита.'
    ---
    
    # Производительность
    
    Baseline: main 23.0+ · Verified: main 26.1000.0
    
    Перед PHP-кодом прочитай `bitrix-framework`, если ещё не читал его в этой задаче.
    
    Кеширование: `bitrix-caching`. Профилирование SQL: `bitrix-database` (SqlTracker). Сессии: `bitrix-sessions`.
    
    ## Композит
    
    Статический HTML берётся из композитного кеша, в том числе напрямую через NGINX; динамические области загружаются следующим запросом. Включение: Настройки → Композитный сайт. Ядро: `Bitrix\Main\Composite\Engine`, `Page`, `StaticArea`, `BufferArea`.
    
    В шаблоне компонента (`$this` — `CBitrixComponentTemplate`):
    
    ```php
    $this->setFrameMode(true);                 // шаблон совместим с композитом
    
    $frame = $this->createFrame()->begin('Загрузка…');  // заглушка в кешированном HTML
    echo htmlspecialcharsbx($arResult['USER_NAME']);   // динамическое содержимое
    $frame->end();
    ```
    
    Объёмная заглушка: `begin()` → динамическое содержимое → `beginStub()` → HTML заглушки → `end()`.
    
    Вне компонентов (шапка шаблона сайта, функции в `init.php`):
    
    ```php
    use Bitrix\Main\Composite\StaticArea;
    
    $area = new StaticArea('vendor_cart_counter');
    $area->setStub('<span>0</span>');
    $area->startDynamicArea();
    echo (int)$basketCount;
    $area->finishDynamicArea();
    ```
    
    - Настройка компонента без кода: параметры `COMPOSITE_FRAME_MODE` (`A`/`Y`/`N`) и `COMPOSITE_FRAME_TYPE` (`AUTO`, `STATIC`, `DYNAMIC_WITH_STUB`, `DYNAMIC_WITHOUT_STUB`).
    - Исключить страницу: `\Bitrix\Main\Composite\Page::getInstance()->markNonCacheable()`.
    - Атрибута `data-dynamic` и свойства страницы `composite_frame_mode` нет.
    - Не оставляй личные данные (имя, корзину, права, CSRF-токены) в статической части. Проверь динамические области гостем и авторизованным пользователем.
    
    ## Запросы
    
    - Выбирай нужные поля; индексируй столбцы `filter`/`order`.
    - Устраняй N+1: `fetchCollection()` + `fill()` либо связи в `select` (`bitrix-orm`).
    - Используй пакетную запись (`addMulti`, `updateMulti`) вместо записи по строке в цикле.
    - Повторные чтения: кеш ORM-запроса; собранные результаты: тегированный кеш данных.
    
    ## Реплики чтения
    
    С модулем `cluster` запросы `SELECT` через `query()` могут уходить на реплику. Чтение сразу после записи закрепляй за основной БД:
    
    ```php
    $pool = \Bitrix\Main\Application::getInstance()->getConnectionPool();
    $pool->useMasterOnly(true);
    try
    {
        $row = OrderTable::getById($id)->fetch();
    }
    finally
    {
        $pool->useMasterOnly(false);
    }
    ```
    
    useMasterOnly() меняет счётчик вложенности: каждому true нужен false в finally.
    
    Дополнительные БД для аналитики и отчётов: именованное подключение в `connections` (`bitrix-database`).
    
    ## Проверка
    
    - [ ] Динамические области композита проверены гостем и авторизованным пользователем.
    - [ ] Если настроена отдача композита через NGINX, проверено попадание в статический кеш.
    - [ ] Медленные запросы найдены через SqlTracker, нужные индексы созданы.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.