getList

\Bitrix\Catalog\Model\Entity public static
\Bitrix\Catalog\Model\Product::getList(
	array $parameters
);

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

Метод унаследован от \Bitrix\Catalog\Model\Entity. Эта страница описывает поля ProductTable и особенности кеша модели Product.

Параметры

Ключи массива $parameters

[
	"ID",
	"TYPE",
	"AVAILABLE",
	"QUANTITY"
]

[
	"=AVAILABLE" => "Y",
	">QUANTITY" => 0,
	"@TYPE" => [1, 4]
]

[
	"TYPE",
	"AVAILABLE"
]

[
	"TYPE" => "ASC",
	"ID" => "DESC"
]

[
	"ttl" => 3600,
	"cache_joins" => true
]

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

Метод возвращает объект \Bitrix\Catalog\Model\Entity. При вызове через Product результат является объектом \Bitrix\Catalog\Model\Product. Метод fetch() последовательно возвращает строки как ассоциативные массивы или false, когда строки закончились.

Если ключ select не задан, строка содержит скалярные поля таблицы:

Исключения

• \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');
}

try
{
	$products = Product::getList([
		'select' => ['ID', 'TYPE', 'AVAILABLE', 'QUANTITY'],
		'filter' => [
			'=AVAILABLE' => 'Y',
			'>QUANTITY' => 0,
		],
		'order' => ['ID' => 'ASC'],
		'limit' => 20,
	]);

	while ($product = $products->fetch())
	{
		print_r($product);
	}
}
catch (Throwable $exception)
{
	echo $exception->getMessage();
}