Управление разделами инфоблоков через PHP в 1С-Битрикс

Вывод всех разделов с вложенностью в виде списка (рекурсивный обход)

Пример демонстрирует рекурсивную функцию, которая строит вложенный HTML-список ul/li на основе всех разделов инфоблока.

function getSectionTree($iblockId, $parentId = 0) {
    $arFilter = array('IBLOCK_ID' => $iblockId, 'IBLOCK_SECTION_ID' => $parentId);
    $rsSections = CIBlockSection::GetList(
        array('SORT' => 'ASC'),
        $arFilter,
        false,
        array('ID', 'NAME', 'DEPTH_LEVEL')
    );
    $result = array();
    while ($arSection = $rsSections->Fetch()) {
        $children = getSectionTree($iblockId, $arSection['ID']);
        $result[] = array(
            'section' => $arSection,
            'children' => $children
        );
    }
    return $result;
}

function renderTree($tree, $level = 0) {
    echo '<ul>';
    foreach ($tree as $node) {
        echo '<li>' . $node['section']['NAME'];
        if (!empty($node['children'])) {
            renderTree($node['children'], $level + 1);
        }
        echo '</li>';
    }
    echo '</ul>';
}

$tree = getSectionTree(2);
renderTree($tree);
  

Результат (выводится HTML с вложенными списками). Примерный вывод при наличии разделов:

<ul>
  <li>Категория 1
    <ul>
      <li>Подкатегория 1.1</li>
    </ul>
  </li>
  <li>Категория 2</li>
</ul>
  

Массовое обновление разделов с использованием транзакции

Когда требуется обновить множество разделов (например, присвоить новый символьный код), безопасно использовать транзакцию, чтобы в случае ошибки откатить изменения.

$iblockId = 2;
$connection = \Bitrix\Main\Application::getConnection();
$connection->startTransaction();
try {
    $rsSections = CIBlockSection::GetList(
        array(),
        array('IBLOCK_ID' => $iblockId),
        false,
        array('ID', 'CODE')
    );
    while ($arSection = $rsSections->Fetch()) {
        if (empty($arSection['CODE'])) {
            $newCode = 'section_' . $arSection['ID'];
            $oSection = new CIBlockSection;
            $result = $oSection->Update($arSection['ID'], array('CODE' => $newCode));
            if (!$result) {
                throw new Exception('Ошибка обновления раздела ' . $arSection['ID'] . ': ' . $oSection->LAST_ERROR);
            }
        }
    }
    $connection->commitTransaction();
    echo 'Обновление успешно завершено.';
} catch (Exception $e) {
    $connection->rollbackTransaction();
    echo 'Ошибка: ' . $e->getMessage();
}
  

Такой подход гарантирует, что если хотя бы одно обновление завершится ошибкой, все изменения будут отменены.

Удаление раздела с проверкой прав и использованием события

При удалении раздела рекомендуется проверять, что у пользователя есть права на удаление, и использовать событие OnBeforeIBlockSectionDelete для дополнительных действий.

// Пример обработчика события (регистрируется в init.php)
\Bitrix\Main\EventManager::getInstance()->addEventHandler(
    'iblock',
    'OnBeforeIBlockSectionDelete',
    function (\Bitrix\Main\Event $event) {
        $id = $event->getParameter('ID');
        // Дополнительная проверка: не удалять корневой раздел
        $rsSection = CIBlockSection::GetByID($id);
        if ($arSection = $rsSection->Fetch()) {
            if ($arSection['DEPTH_LEVEL'] == 1 && $arSection['IBLOCK_SECTION_ID'] == 0) {
                return new \Bitrix\Main\EventResult(
                    \Bitrix\Main\EventResult::ERROR,
                    new \Bitrix\Main\Error('Нельзя удалить корневой раздел.')
                );
            }
        }
        return new \Bitrix\Main\EventResult(\Bitrix\Main\EventResult::SUCCESS);
    }
);

// Сам код удаления
$sectionId = 123;
$oSection = new CIBlockSection;
if ($oSection->Delete($sectionId)) {
    echo 'Раздел удален.';
} else {
    echo 'Ошибка: ' . $oSection->LAST_ERROR;
}
  

Пользовательские права на удаление обычно проверяются через $USER->CanDoOperation('iblock_element_delete') и т.п.

Выборка разделов по внешнему коду (XML_ID) для синхронизации с внешней системой

Использование поля XML_ID позволяет сопоставлять разделы с данными из внешних источников. Пример поиска раздела по XML_ID и обновления его названия.

$externalCode = 'ext_12345';
$rsSection = CIBlockSection::GetList(
    array(),
    array('XML_ID' => $externalCode, 'IBLOCK_ID' => 2),
    false,
    array('ID', 'NAME')
);
if ($arSection = $rsSection->Fetch()) {
    $oSection = new CIBlockSection;
    $oSection->Update($arSection['ID'], array('NAME' => 'Обновленное имя'));
    echo 'Раздел с XML_ID = ' . $externalCode . ' обновлен.';
} else {
    echo 'Раздел с XML_ID не найден. Возможно, требуется создание.';
}
  

Такой подход часто используется при импорте/экспорте данных из ERP-систем.