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