bitrix-controllers

Bitrix コントローラー

基準：main 23.0+ · 検証済み：main 26.800.0

タスク	参照先
ファイル、アクション名、最小構成のコントローラー、自動注入パラメーター、PageNavigation	rules/basics.md
デフォルトのプリフィルター、フィルター属性、configureActions()、#[ActionAccess]、カスタムフィルター	rules/filters.md
エラー、JSON エンベロープ、レスポンスクラス、renderView()、スコープ、REST v3	rules/errors-response.md

不変条件

• アクションの役割はオーケストレーションのみです：入力 → サービス → Result → データまたは addErrors()。サービスはアクションのパラメーターとして受け取ります（DI の規範：bitrix-framework）。
• フィルター属性は main 26.250* 以降です。古いカーネルでは configureActions() を使用してください。1 つのアクションで両方を使用しないでください（ActionConfigurationException）。
• METHOD_* 定数は属性 Attribute\Rule\HttpMethod ではなく、ActionFilter\HttpMethod にあります。属性側で参照するとコントローラーの構築時に例外が発生し、そのコントローラーのすべてのアクションが失敗します。
• ルール属性はデフォルトのフィルター（Authentication、HttpMethod([GET, POST])、Csrf）に追加されます。#[Authentication] または #[Csrf] を再度追加すると、フィルターが 2 回実行されます。
• ファイル名が PascalCase の場合、コントローラーのセグメントもクラス名の大文字小文字に合わせて記述します：vendor:module.Post.create。小文字の post は lib/infrastructure/controller/post.php に解決され、Linux では失敗します。REST ではメソッド名が小文字に変換されるため、PascalCase のコントローラーには従来の REST 経由で到達できません（bitrix-rest）。
• HTML（renderView／renderComponent）を使えるのは、ルートから到達するコントローラーのみです。BX.ajax.runAction() は JSON を想定しています。