getrow

?array public static
\Bitrix\Catalog\Model\Entity::getRow(
	array $parameters
);

Метод возвращает первую строку ORM-выборки дочерней модели. Статический метод.

Параметры

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

Метод возвращает строку как ассоциативный массив или null, если запись не найдена.

Как работает метод

Метод добавляет ограничение одной строки, вызывает getList() дочерней модели и один раз вызывает fetch(). Поэтому результат также участвует в заполнении внутреннего кеша.

Исключения

• \Bitrix\Main\ArgumentException — параметры ORM-запроса содержат некорректное значение,
• \Bitrix\Main\ObjectNotFoundException — модель не смогла получить объект ORM-таблицы,
• \Bitrix\Main\ObjectPropertyException — ORM не смогла получить свойство объекта,
• \Bitrix\Main\SystemException — ORM не смогла построить или выполнить запрос.

Пример

<?php

use Bitrix\Catalog\Model\Product;
use Bitrix\Main\Loader;

if (!Loader::includeModule('catalog'))
{
	throw new RuntimeException('Не удалось подключить модуль catalog');
}

// Идентификатор существующего товара
$productId = 123;
$product = Product::getRow([
	'select' => ['ID', 'TYPE', 'AVAILABLE'],
	'filter' => ['=ID' => $productId],
]);

if ($product === null)
{
	echo 'Товар не найден';
	return;
}

print_r($product);