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

fetch

array|false public
\Bitrix\Catalog\Model\Entity::fetch(
	?\Bitrix\Main\Text\Converter $converter = null
);

Метод возвращает следующую строку активной выборки и обновляет внутренний кеш модели. Нестатический метод.

Параметры

ПараметрОписание
$converterКонвертер текста, который метод передает объекту результата ORM. По умолчанию — null

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

Метод возвращает строку как ассоциативный массив. Если активной выборки нет или строки закончились, метод возвращает false.

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

Активный результат устанавливает getList(). Если строка содержит ID и полный набор кешируемых полей, метод сохраняет данные во внутреннем кеше.

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

Пример

<?php

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

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

// Идентификатор существующего товара
$productId = 123;
$prices = Price::getList([
	'select' => ['ID', 'PRICE', 'CURRENCY'],
	'filter' => ['=PRODUCT_ID' => $productId],
]);

while ($price = $prices->fetch())
{
	print_r($price);
}


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