bitrix-controllers
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseКонтроллеры Битрикса
Bitrix 控制器
Baseline: main 23.0+ · Verified: main 26.1000.0
Перед PHP-кодом прочитай , если ещё не читал его в этой задаче.
В таблице выбери только нужный ; пути относительны каталогу скилла.
bitrix-frameworkrules/*.md| Задача | Читать |
|---|---|
| Файлы, имена действий, минимальный контроллер, параметры DI, PageNavigation | |
Стандартные фильтры, атрибуты, | |
Ошибки, JSON-обёртка, классы ответов, | |
基线:main 23.0+ · 已验证:main 26.1000.0
在编写 PHP 代码前,如果本任务中尚未阅读 ,请先阅读。
在表格中只选择所需的 ;路径相对于 skill 目录。
bitrix-frameworkrules/*.md| 任务 | 阅读 |
|---|---|
| 文件、动作名称、最小控制器、DI 参数、PageNavigation | |
标准过滤器、属性、 | |
错误、JSON 包装、响应类、 | |
Обязательные правила
强制规则
- Действие только связывает ввод → сервис → → данные или
Result. Сервисы передаются параметрами действия (канон DI:addErrors()).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и не работает на Linux. REST приводит имена методов к нижнему регистру: PascalCase-контроллер недоступен через классический REST (lib/infrastructure/controller/post.php).bitrix-rest - HTML (/
renderView) возвращай только через маршруты;renderComponentожидает JSON.BX.ajax.runAction()
- 动作只负责连接输入 → 服务 → → 数据或
Result。服务通过动作参数传入(标准 DI:addErrors())。bitrix-framework - 过滤器属性从 main 26.250* 起可用;此前使用 。同一个动作不要同时使用两种方式:
configureActions()。ActionConfigurationException - 常量属于
METHOD_*,而不是ActionFilter\HttpMethod属性。引用这些常量会导致控制器及其所有动作无法创建。Attribute\Rule\HttpMethod - 规则属性会在标准过滤器(、
Authentication、HttpMethod([GET, POST]))基础上添加过滤器。重复使用Csrf或#[Authentication]会将过滤器执行两次。#[Csrf] - 对于 PascalCase 文件,控制器段应使用类名对应的注册形式:。小写的
vendor:module.Post.create仅允许用于post,在 Linux 上不可用。REST 会将方法名转换为小写:通过传统 REST(lib/infrastructure/controller/post.php)无法访问 PascalCase 控制器。bitrix-rest - HTML(/
renderView)只能通过路由返回;renderComponent预期返回 JSON。BX.ajax.runAction()