Получить одну запись DataManager::getRow

Модуль: main — подключать отдельно не нужно

Метод DataManager::getRow выбирает одну запись по параметрам getList и возвращает ее массивом. Метод сам задает limit равным 1.

Сигнатура метода в классе Bitrix\Main\ORM\Data\DataManager:

public static function getRow(array $parameters)

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
parameters* array Задает параметры, как в getList. Метод заменяет значение ключа limit на 1

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

Метод возвращает массив или null, если записи нет.

Особенности

Если условиям соответствуют несколько записей, метод вернет первую. Задайте order, чтобы результат не зависел от порядка строк в базе данных.

Примеры

Пример. Код получает последний по коду язык:

<?php
use Bitrix\Main\Localization\LanguageTable;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$row = LanguageTable::getRow([
    'select' => ['LID', 'NAME'],
    'filter' => ['@LID' => ['en', 'ru']],
    'order' => ['LID' => 'DESC'],
]);

echo $row['LID'] . ' ' . var_export(LanguageTable::getRow(['filter' => ['=LID' => 'zz']]), true);

Код выведет ru NULL.

Смотрите также