bitrix-orm

Bitrix D7 ORM

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

タスク	参照
タブレット、フィールド型、ArrayField、データモディファイアー、リレーション、UF	rules/tablet-map.md
query()、フィルター、ランタイムフィールド、DISTINCT、ページネーション	rules/reading.md
コレクション：保存、削除、リレーション、検索／フィルター、キー	rules/collections.md
add/update/delete、バッチ、アトミックなインクリメント、マージ、deleteByFilter	rules/writing.md
ORM イベント、クエリーキャッシュ、クエリー内のユーザー入力	rules/events-cache-security.md

不変条件

• 名前空間は Bitrix\Main\ORM\* です。Bitrix\Main\Entity\* はレガシーエイリアスの一覧（main/include/compatibility.php）です。新しいコードでは使用せず、1 つのファイル内で両方を混在させないでください。
• クエリーは XxxTable::query() で構築し、new Query(XxxTable::getEntity()) は使用しないでください。query() はタブレットの getQueryClass() を尊重します。
• add／update／delete／save() はイベントを実行し、cleanCache() を呼び出します。MergeTrait::merge() と deleteByFilter() はイベントを発火しません。生の SQL もキャッシュを古いままにします。
• コレクションに delete() はありません。remove() はメモリ上で関連付けを解除するだけです。
• ホワイトリストなしで、リクエストデータを select、order、group、runtime、ExpressionField に渡さないでください。