bitrix-highloadblock

Highload 块

基线：main 23.0+ · 已验证：highloadblock 25.100.0、main 26.800.0

列为用户字段（UF_*）的扁平 ORM 表：没有分区、树结构或 SEO。需要这些功能 → bitrix-iblocks；架构由代码管理 → 自建数据表（bitrix-orm）。

任务	阅读
创建／重命名／删除块、UF 字段、存储布局、重新编译、迁移	rules/manage-blocks.md
记录的增删改查、多值／文件值、错误、幂等导入	rules/records.md
hlblock 关联、_REF／_SINGLE、iblock directory 属性	rules/relations-directory.md
ORM 事件（双重分发）、hl_element_* 权限	rules/events-rights.md
highloadblock.list／highloadblock.view	rules/components.md
批处理、索引、缓存、SQL 跟踪、诊断	rules/performance.md

不变条件

• 首先调用 Loader::includeModule('highloadblock')。按稳定的 NAME 查找块；数字 ID 在不同环境中各不相同。
• 每个请求调用一次 HighloadBlockTable::compileEntity($idOrNameOrRow)，然后调用 $entity->getDataClass()。遇到未知块时会抛出 SystemException。
• 仅通过数据类（add／update／delete）写入，绝不对 HL 表或其多值表执行原始 SQL。
• add()／update() 会静默丢弃未知键：使用 $dataClass::getEntity()->hasField() 检查字段代码。
• 数据类调用绝不检查权限；请自行检查 hl_element_*。
• UF、NAME 或 TABLE_NAME 更改后，请在新请求中继续操作。