bitrix-routing

Bitrix ルーティング

ベースライン：main 23.0+ · 検証済み：main 26.800.0

タスク	参照先
Web サーバーのルール、routing 設定、モジュールのルートファイル	rules/setup.md
web.php、HTTP メソッド、パラメーター、名前、グループ、クロージャーハンドラー	rules/routes-handlers.md
コントローラー上の公開ページ、PublicPageController	rules/public-pages.md
マッチ順序、コンパイルキャッシュ、サイトガード、urlrewrite.php の移行	rules/matching-legacy.md

不変条件

• ユーザーのルートは /local/routes/*.php にのみ定義し、routing.config ではベース名で指定します。モジュールのルートファイルは、そこから require で読み込みます。
• ハンドラーは薄く保ちます。認証、CSRF、または安定した契約が必要な処理には [Controller::class, 'action'] を使います。ルーティングされたコントローラーはフィルター（bitrix-controllers）で保護し、->middleware() は決して使いません。
• ルーティングされたコントローラーは SCOPE_AJAX で実行されます。デフォルトの Authentication と Csrf は GET ページにも適用されます。公開読み取り専用ページでは、アクションごとにこれらを無効にします。
• 状態を変更するルートには明示的な HTTP メソッド（get／post／…）を指定し、すべてのパラメーターに ->where() を設定します。
• 同じパスに物理ファイルがある場合は、そのファイルがルートより優先されます。Web サーバーは routing_index.php より先に物理ファイルを配信します。