walk() для ORM-коллекций: практичные массовые операции с инфоблоками
Проблема/контекст
В D7 вы часто получаете из ORM не массив, а типизированную коллекцию объектов через fetchCollection(). Перебирать её через foreach нормально, но в реальном коде обычно хочется:
- компактно “пройтись и изменить” объекты;
- сохранить изменения одной цепочкой вызовов;
- не плодить лишние временные переменные.
Начиная с main 26.0.0 у Bitrix\Main\ORM\Objectify\Collection появился метод walk(): это “аналог foreach, но как метод”, который удобно вставляется в цепочку.
Решение с кодом
walk() вызывает ваш callback для каждого объекта коллекции и возвращает эту же коллекцию (для чейнинга). В callback приходят:
- объект сущности,
- ключ итерации — это ключ внутреннего массива коллекции (обычно сериализованный первичный ключ; для составного — строка).
Пример 1. Массово деактивировать элементы инфоблока и сохранить одной цепочкой
Частый кейс: найти элементы по условию, поставить ACTIVE = 'N' и сохранить максимально “чисто”.
<?php
declare(strict_types=1);
use Bitrix\Iblock\ElementTable;
use Bitrix\Main\Loader;
function deactivateSectionElements(int $iblockId, int $sectionId): void
{
Loader::includeModule('iblock');
$saveResult = ElementTable::query()
->setSelect(['ID', 'ACTIVE', 'IBLOCK_ID', 'IBLOCK_SECTION_ID'])
->where('IBLOCK_ID', $iblockId)
->where('IBLOCK_SECTION_ID', $sectionId)
->where('ACTIVE', 'Y')
->fetchCollection()
->walk(static function($element): void {
$element->setActive('N');
})
->save()
;
if (!$saveResult->isSuccess())
{
throw new \RuntimeException(implode('; ', $saveResult->getErrorMessages()));
}
}
Практические детали:
- При одинаковом изменении для всех объектов
save()умеет выполнять групповой UPDATE (однотипные правки). Это как раз тот случай, когдаwalk()хорошо “стыкуется” с коллекциями. - Если вы меняете разные значения для каждого объекта (например,
SORTпо формуле), ORM может уйти в сериюUPDATEпо одному объекту.
Пример 2. “Пройтись и собрать” данные без лишнего foreach
walk() удобен не только для мутаций, но и для побочных эффектов: собрать ID, составить карту, подсчитать суммы.
<?php
declare(strict_types=1);
use Bitrix\Iblock\ElementTable;
use Bitrix\Main\Loader;
function collectElementIdsAndNames(int $iblockId, int $limit = 50): array
{
Loader::includeModule('iblock');
$ids = [];
$namesById = [];
ElementTable::query()
->setSelect(['ID', 'NAME'])
->where('IBLOCK_ID', $iblockId)
->setLimit($limit)
->fetchCollection()
->walk(static function($element, $key) use (&$ids, &$namesById): void {
$id = (int)$element->getId();
$ids[] = $id;
$namesById[$id] = (string)$element->getName();
})
;
return [
'ids' => $ids,
'namesById' => $namesById,
];
}
Пример 3. Когда walk() лучше, чем filter()
У коллекции есть “функциональный” filter(), но он не сработает, если в коллекции есть несохранённые изменения — тогда выбрасывается CollectionFilterException.
Поэтому практическое правило такое:
- хотите “сначала отобрать, потом поменять” — делайте
filter()первым шагом; - хотите просто “пройтись и поменять” — берите
walk().
<?php
declare(strict_types=1);
use Bitrix\Iblock\ElementTable;
use Bitrix\Main\Loader;
function deactivateActiveElementsInIblock(int $iblockId): void
{
Loader::includeModule('iblock');
$saveResult = ElementTable::query()
->setSelect(['ID', 'ACTIVE'])
->where('IBLOCK_ID', $iblockId)
->fetchCollection()
->filter(static fn($element) => $element->getActive() == 'Y')
->walk(static function($element): void {
$element->setActive('N');
})
->save();
if (!$saveResult->isSuccess())
{
throw new \RuntimeException(implode('; ', $saveResult->getErrorMessages()));
}
}
Ограничения, о которых полезно помнить
walk()не даёт “прервать” обход по условию. Если нужен ранний выход — используйтеforeachилиfind()у коллекции.- В callback вторым аргументом приходит ключ итерации. Он удобен для отладки/логики по PK, но не стоит на него “завязывать” бизнес-логику (особенно при составных ключах).
Итог
walk() — маленький метод, но в D7 он хорошо раскрывается именно в связке fetchCollection() -> walk() -> save(): получается компактный, читабельный и часто более производительный массовый апдейт.
