Документация для разработчиков
Темная тема

checkElement

bool public static CIBlockFindTools::checkElement(
	int $iblock_id,
	array &$arVariables,
	bool $strict_check = false
);

Метод проверяет существование элемента информационного блока по переменным компонента и дополняет массив $arVariables данными найденного элемента. Метод статический.

Параметры вызова

Параметр Описание
$iblock_id ID информационного блока, в котором нужно проверить элемент.
$arVariables Массив переменных компонента. Может содержать ELEMENT_ID, ELEMENT_CODE, SECTION_ID, SECTION_CODE или SECTION_CODE_PATH. Передается по ссылке и при успешной проверке дополняется данными найденного элемента.
$strict_check Если передано true, метод выполняет строгую проверку принадлежности элемента разделу из переменных компонента.

Возвращаемое значение

Метод возвращает true, если элемент найден, иначе false.

Особенности

  • Метод может использовать ID или символьный код элемента.
  • Если в переменных указан путь раздела, метод учитывает его при проверке элемента.
  • При успешной проверке в $arVariables устанавливается ID найденного элемента.

Примеры

Проверка элемента по символьному коду и пути раздела:

use Bitrix\Main\Loader;

Loader::includeModule('iblock');

$iblockId = 2;
$variables = array(
    'SECTION_CODE_PATH' => 'catalog/phones',
    'ELEMENT_CODE' => 'smartphone-model',
);

if (CIBlockFindTools::checkElement($iblockId, $variables, true))
{
    echo 'ID element: ' . $variables['ELEMENT_ID'];
}
else
{
    echo 'Element not found';
}


© «Битрикс», 2001-2026, «1С-Битрикс», 2026