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