Программная работа с разделами каталога в Битрикс: от простого к сложному

Расширенные примеры работы с разделами

Пример 1: Вывод разделов с полной иерархией за один SQL-запрос и построение дерева на PHP.

$iblockId = 2;
$rs = CIBlockSection::GetList(
    array('LEFT_MARGIN' => 'ASC'),
    array('IBLOCK_ID' => $iblockId, 'ACTIVE' => 'Y'),
    false,
    array('ID', 'NAME', 'DEPTH_LEVEL', 'LEFT_MARGIN', 'RIGHT_MARGIN', 'IBLOCK_SECTION_ID')
);
$sections = array();
while ($ar = $rs->Fetch()) {
    $ar['CHILDREN'] = array();
    $sections[$ar['ID']] = $ar;
}
// Построение дерева по ссылкам
$tree = array();
foreach ($sections as $id => &$section) {
    if ($section['IBLOCK_SECTION_ID'] > 0) {
        $sections[$section['IBLOCK_SECTION_ID']]['CHILDREN'][] = &$section;
    } else {
        $tree[] = &$section;
    }
}
unset($section);
print_r($tree);

Array
(
    [0] => Array
        (
            [ID] => 10
            [NAME] => Одежда
            [DEPTH_LEVEL] => 1
            [IBLOCK_SECTION_ID] => 0
            [CHILDREN] => Array
                (
                    [0] => Array
                        (
                            [ID] => 15
                            [NAME] => Платья
                            [DEPTH_LEVEL] => 2
                            [IBLOCK_SECTION_ID] => 10
                            [CHILDREN] => Array()
                        )
                )
        )
)

Пример 2: Использование SectionTable::getList с фильтром по коду и пагинацией.

use Bitrix\Main\Entity\Query;
use Bitrix\Iblock\SectionTable;

$query = new Query(SectionTable::getEntity());
$query->setSelect(array('ID', 'NAME', 'CODE'));
$query->setFilter(array('IBLOCK_ID' => 2, '=CODE' => 'odezhda'));
$query->setLimit(5);
$result = $query->exec();
while ($row = $result->fetch()) {
    echo 'Код: ' . $row['CODE'] . ' - ' . $row['NAME'] . '<br>';
}

Код: odezhda - Одежда

Пример 3: Получение раздела по символьному коду и вывод его полного пути.

// Функция для получения цепочки родителей
function getSectionChain($iblockId, $sectionCode) {
    $rs = CIBlockSection::GetList(
        array(),
        array('IBLOCK_ID' => $iblockId, '=CODE' => $sectionCode, 'ACTIVE' => 'Y'),
        false,
        array('ID', 'IBLOCK_SECTION_ID', 'NAME', 'CODE')
    );
    if ($section = $rs->Fetch()) {
        $chain = array($section);
        // Получаем родителей рекурсивно
        $parentId = $section['IBLOCK_SECTION_ID'];
        while ($parentId > 0) {
            $rsParent = CIBlockSection::GetByID($parentId);
            if ($parent = $rsParent->Fetch()) {
                $chain[] = $parent;
                $parentId = $parent['IBLOCK_SECTION_ID'];
            } else {
                break;
            }
        }
        return array_reverse($chain);
    }
    return array();
}
$chain = getSectionChain(2, 'platya');
foreach ($chain as $s) {
    echo $s['NAME'] . ' > ';
}

Одежда > Платья >

Пример 4: Применение кэширования при получении списка разделов.

$cache = new CPHPCache();
$cacheTime = 3600;
$cacheId = 'sections_iblock_2';
$cacheDir = '/sections/';
if ($cache->InitCache($cacheTime, $cacheId, $cacheDir)) {
    $vars = $cache->GetVars();
    $arSections = $vars['SECTIONS'];
} else {
    $arSections = array();
    $rs = CIBlockSection::GetList(
        array('SORT' => 'ASC'),
        array('IBLOCK_ID' => 2, 'ACTIVE' => 'Y'),
        false,
        array('ID', 'NAME', 'CODE', 'IBLOCK_SECTION_ID', 'DEPTH_LEVEL')
    );
    while ($ar = $rs->Fetch()) {
        $arSections[] = $ar;
    }
    $cache->StartDataCache($cacheTime, $cacheId, $cacheDir);
    $cache->EndDataCache(array('SECTIONS' => $arSections));
}
// Далее работаем с $arSections
print_r($arSections);

Array
(
    [0] => Array
        (
            [ID] => 10
            [NAME] => Одежда
            [CODE] => odezhda
            [IBLOCK_SECTION_ID] => 0
            [DEPTH_LEVEL] => 1
        )
    [1] => Array
        (
            [ID] => 15
            [NAME] => Платья
            [CODE] => platya
            [IBLOCK_SECTION_ID] => 10
            [DEPTH_LEVEL] => 2
        )
)

Пример 5: Фильтрация разделов по пользовательскому свойству (UFL) с помощью CIBlockSection::GetList.

$arFilter = array(
    'IBLOCK_ID' => 2,
    'ACTIVE' => 'Y',
    'PROPERTY_SPECIAL_OFFER' => 'Y'  // предположим, есть свойство SPECIAL_OFFER типа "Да/Нет"
);
$rs = CIBlockSection::GetList(array('SORT' => 'ASC'), $arFilter, false, array('ID', 'NAME'));
while ($ar = $rs->Fetch()) {
    echo $ar['NAME'] . '<br>';
}

Распродажа

Пример 6: Обновление раздела через CIBlockSection::Update с проверкой ошибок.

$fields = array(
    'NAME' => 'Новое название раздела',
    'SORT' => 500
);
$res = CIBlockSection::Update(10, $fields); // ID раздела = 10
if ($res) {
    echo 'Раздел обновлен успешно';
} else {
    global $APPLICATION;
    $strError = $APPLICATION->GetException();
    echo 'Ошибка: ' . $strError->GetString();
}

Раздел обновлен успешно