ORM: получение информации о разделах инфоблока на D7, использование Bitrix\Iblock\SectionTable и пользовательских полей

Основное использование Bitrix\Iblock\SectionTable

Bitrix\Iblock\SectionTable предоставляет удобный способ получения данных о разделах инфоблока. Пример ниже демонстрирует, как можно получить все разделы конкретного инфоблока:

use Bitrix\Main\Loader;
use Bitrix\Iblock\SectionTable;
Loader::includeModule('iblock');
$IBLOCK_ID = 10; // ID инфоблока
$getSections = SectionTable::getList([
    'filter' => [
        'IBLOCK_ID' => $IBLOCK_ID // Указываем конкретный инфоблок
    ],
    'select' => [
        '*',
    ]
])->fetchAll();
foreach ($getSections as $getSection) {
    var_dump($getSection);
}

Этот код выполняет следующее:

• Подключает модуль iblock через Loader::includeModule.
• Указывает ID инфоблока для фильтрации.
• Использует метод getList класса SectionTable, чтобы получить все разделы указанного инфоблока.
• Перебирает массив разделов и выводит их содержимое с помощью var_dump.

Cтандартный класс SectionTable возвращает только основные поля разделов, такие как ID, NAME, CODE и другие. Пользовательские поля (например, UF_*) не доступны через этот класс.

Получение пользовательских полей раздела через ORM

Пользовательские поля разделов (поля с префиксом UF_) нельзя получить с использованием SectionTable. Для работы с ними существует пространство имен \Bitrix\Iblock\Model, которое предоставляет механизм единого управления свойствами инфоблоков.

Для получения данных пользовательских полей разделов можно использовать класс \Bitrix\Iblock\Model\Section. Пример ниже демонстрирует, как это сделать:

use Bitrix\Main\Loader;
use Bitrix\Iblock\Model\Section;
Loader::includeModule('iblock');
$IBLOCK_ID = 10; // ID инфоблока
$entitySections = Section::compileEntityByIblock($IBLOCK_ID);
$getSections = $entitySections::getList([
    'select' => [
        '*',        // Основные поля
        'UF_*'      // Пользовательские поля
    ],
])->fetchAll();
foreach ($getSections as $getSection) {
    var_dump($getSection);
}

• Подключаем модуль iblock через Loader::includeModule.
• Используем метод compileEntityByIblock класса Section, чтобы создать сущность разделов для указанного инфоблока.
• С помощью метода getList получает как стандартные, так и пользовательские поля разделов.
• Перебираем полученные данные и выводим их содержимое.

Подробно о \Bitrix\Iblock\Model\Section

Класс \Bitrix\Iblock\Model\Section входит в пространство имен \Bitrix\Iblock\Model и предоставляет расширенные возможности для работы с разделами инфоблоков. Основные преимущества:

• Единое управление свойствами: Позволяет работать с пользовательскими полями, которые не доступны через стандартные ORM-классы.
• Динамическая компиляция сущностей: Метод compileEntityByIblock создает ORM-сущность на основе структуры указанного инфоблока. Это дает возможность работать с пользовательскими полями, не создавая дополнительных классов.
• Гибкость: Поддерживает выборку, фильтрацию и сортировку данных с учетом пользовательских полей.

use Bitrix\Main\Loader;
use Bitrix\Iblock\Model\Section;
Loader::includeModule('iblock');
$IBLOCK_ID = 15; // ID инфоблока
$entity = Section::compileEntityByIblock($IBLOCK_ID);
$sections = $entity::getList([
    'filter' => ['ACTIVE' => 'Y'],
    'select' => ['ID', 'NAME', 'UF_CUSTOM_FIELD'],
])->fetchAll();
foreach ($sections as $section) {
    echo "ID: {$section['ID']}, NAME: {$section['NAME']}, CUSTOM FIELD: {$section['UF_CUSTOM_FIELD']}\n";
}

В этом примере выполняется выборка только активных разделов инфоблока с указанными пользовательскими полями.

Выбор подхода зависит от ваших потребностей и сложности задачи. Если вам нужно получить только стандартные поля разделов, то достаточно использовать SectionTable. Если же требуется работа с пользовательскими полями, рекомендуется использовать механизм из пространства имен \Bitrix\Iblock\Model