bitrix-controllers
Engine Controller/JsonController: thin actions, filter attributes, CurrentUser, errors. Use for AJAX/REST/routed endpoints.
Install
npx skills add https://github.com/bxmaximum/bitrix-framework-skills/tree/main/skills/bitrix-controllers
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
Контроллеры Битрикса
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.
Reviews (0)
No reviews yet.
No comments yet.