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-framework
, если ещё не читал его в этой задаче. В таблице выбери только нужный
rules/*.md
; пути относительны каталогу скилла.
ЗадачаЧитать
Файлы, имена действий, минимальный контроллер, параметры DI, PageNavigation
rules/basics.md
Стандартные фильтры, атрибуты,
configureActions()
,
#[ActionAccess]
, свой фильтр
rules/filters.md
Ошибки, JSON-обёртка, классы ответов,
renderView()
, подпись экспорта, REST v3
rules/errors-response.md
基线:main 23.0+ · 已验证:main 26.1000.0
在编写 PHP 代码前,如果本任务中尚未阅读
bitrix-framework
,请先阅读。 在表格中只选择所需的
rules/*.md
;路径相对于 skill 目录。
任务阅读
文件、动作名称、最小控制器、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.
  • 动作只负责连接输入 → 服务 →
    Result
    → 数据或
    addErrors()
    。服务通过动作参数传入(标准 DI:
    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
    仅允许用于
    lib/infrastructure/controller/post.php
    ,在 Linux 上不可用。REST 会将方法名转换为小写:通过传统 REST(
    bitrix-rest
    )无法访问 PascalCase 控制器。
  • HTML(
    renderView
    /
    renderComponent
    )只能通过路由返回;
    BX.ajax.runAction()
    预期返回 JSON。