Claude Skill

bitrix-controllers

Engine Controller/JsonController: thin actions, filter attributes, CurrentUser, errors. Use for AJAX/REST/routed endpoints.

LLM Mart · 0 points · 19 views 0 listing impressions 0 install-command copies
Download bxmaximum-bitrix-framework-skills-skills_bitrix-controllers-0c65452.zip · 10 KB

Install

skills CLI npx skills add https://github.com/bxmaximum/bitrix-framework-skills/tree/main/skills/bitrix-controllers
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, если ещё не читал его в этой задаче. В таблице выбери только нужный rules/*.md; пути относительны каталогу скилла.

Задача Читать
Файлы, имена действий, минимальный контроллер, параметры DI, PageNavigation rules/basics.md
Стандартные фильтры, атрибуты, configureActions(), #[ActionAccess], свой фильтр rules/filters.md
Ошибки, JSON-обёртка, классы ответов, renderView(), подпись экспорта, REST v3 rules/errors-response.md

Обязательные правила

  • Действие только связывает ввод → сервис → Result → данные или addErrors(). Сервисы передаются параметрами действия (канон DI: bitrix-framework).
  • Атрибуты фильтров доступны Since main 26.250*; раньше используй configureActions(). Не совмещай оба способа для одного действия: ActionConfigurationException.
  • Константы METHOD_* принадлежат ActionFilter\HttpMethod, а не атрибуту Attribute\Rule\HttpMethod. Обращение к ним на атрибуте ломает создание контроллера и все его действия.
  • Атрибуты правил добавляют фильтры к стандартным (Authentication, HttpMethod([GET, POST]), Csrf). Повторный #[Authentication] или #[Csrf] запускает фильтр дважды.
  • При файлах PascalCase сегмент контроллера пиши в регистре класса: vendor:module.Post.create. Строчный post разрешается в lib/infrastructure/controller/post.php и не работает на Linux. REST приводит имена методов к нижнему регистру: PascalCase-контроллер недоступен через классический REST (bitrix-rest).
  • HTML (renderView/renderComponent) возвращай только через маршруты; BX.ajax.runAction() ожидает JSON.
Files (bitrix-framework-skills)
  • rules
    • basics.md 7.5 KB
      Loading…
    • errors-response.md 7.2 KB
      Loading…
    • filters.md 6.3 KB
      Loading…
  • SKILL.md 2.8 KB
    ---
    name: bitrix-controllers
    description: 'Используй для AJAX-действий и контроллеров маршрутов Битрикса: Engine\Controller, параметры, фильтры, #[ActionAccess] и ответы. Вызовы BX.ajax.runAction и диагностика ошибок.'
    ---
    
    # Контроллеры Битрикса
    
    Baseline: main 23.0+ · Verified: main 26.1000.0
    
    Перед PHP-кодом прочитай `bitrix-framework`, если ещё не читал его в этой задаче.
    В таблице выбери только нужный `rules/*.md`; пути относительны каталогу скилла.
    
    | Задача | Читать |
    | --- | --- |
    | Файлы, имена действий, минимальный контроллер, параметры DI, PageNavigation | `rules/basics.md` |
    | Стандартные фильтры, атрибуты, `configureActions()`, `#[ActionAccess]`, свой фильтр | `rules/filters.md` |
    | Ошибки, JSON-обёртка, классы ответов, `renderView()`, подпись экспорта, REST v3 | `rules/errors-response.md` |
    
    ## Обязательные правила
    
    - Действие только связывает ввод → сервис → `Result` → данные или `addErrors()`. Сервисы передаются параметрами действия (канон DI: `bitrix-framework`).
    - Атрибуты фильтров доступны **Since main 26.250\***; раньше используй `configureActions()`. Не совмещай оба способа для одного действия: `ActionConfigurationException`.
    - Константы `METHOD_*` принадлежат `ActionFilter\HttpMethod`, а не атрибуту `Attribute\Rule\HttpMethod`. Обращение к ним на атрибуте ломает создание контроллера и все его действия.
    - Атрибуты правил добавляют фильтры к стандартным (`Authentication`, `HttpMethod([GET, POST])`, `Csrf`). Повторный `#[Authentication]` или `#[Csrf]` запускает фильтр дважды.
    - При файлах PascalCase сегмент контроллера пиши в регистре класса: `vendor:module.Post.create`. Строчный `post` разрешается в `lib/infrastructure/controller/post.php` и не работает на Linux. REST приводит имена методов к нижнему регистру: PascalCase-контроллер недоступен через классический REST (`bitrix-rest`).
    - HTML (`renderView`/`renderComponent`) возвращай только через маршруты; `BX.ajax.runAction()` ожидает JSON.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.