Чтение результата — `DB_Result`

← Назад к разделу БД

DB::query() возвращает объект DB_Result. Методы ниже извлекают из него данные. Класс — App\Common\Db\DB_Result.

Много строк

`getAll()`

Все строки — массив ассоциативных массивов. На пустой выборке возвращает false, а не [].

$rows = DB::query('SELECT * FROM ' . $t . ' WHERE rubric_id = %i', 5)->getAll() ?: array();
foreach ($rows as $row) {
    echo $row['document_title'];
}

⚠️ Всегда пишите ?: array() — иначе foreach по false даст предупреждение.

Одна строка

Метод	Возвращает	Пусто
`getAssoc()`	Ассоциативный массив (`$row['field']`)	`false`
`getObject()`	Объект (`$row->field`)	`false`
`getArray()`	Числовой массив (`$row[0]`)	`false`
`getMixed()`	И числовые, и строковые ключи	`false`

Все они читают текущую строку и сдвигают внутренний указатель — можно вызывать в цикле для потоковой обработки.

$doc = DB::query('SELECT * FROM ' . $t . ' WHERE Id = %i', 42)->getAssoc();
if ($doc) { echo $doc['document_title']; }

// потоково по одной строке (экономит память на больших выборках)
$res = DB::queryRawUnbuf('SELECT Id, document_title FROM ' . $t);
while ($row = $res->getAssoc()) { process($row); }

Отдельного getRow() нет — для одной строки используйте getAssoc().

Одно значение (скаляр)

`getValue()`

Первый столбец текущей строки; сдвигает указатель. Пусто → false.

$count = (int) DB::query('SELECT COUNT(*) FROM ' . $t)->getValue();
$title = DB::query('SELECT document_title FROM ' . $t . ' WHERE Id = %i', 42)->getValue();

`getOne()`

Первый столбец первой строки; перематывает результат к началу. Пусто → null.

$max = DB::query('SELECT MAX(position) FROM ' . $t)->getOne();

getValue() двигает указатель (удобно для агрегатов), getOne() всегда берёт самую первую ячейку — разница важна, если читаете результат несколько раз.

Навигация и метаданные

Метод	Назначение
`count()` / `numRows()`	Число строк в выборке.
`numAllRows($result)`	Число строк без `LIMIT` (`SQL_CALC_FOUND_ROWS`).
`dataSeek($i)`	Переместить указатель на строку `$i`.
`numFields()` / `fetchFields()` / `fieldName($i)`	Метаданные полей.
`Close()`	Освободить результат.

$res = DB::query('SELECT * FROM ' . $t . ' LIMIT 10');
echo $res->count();        // 10
$res->dataSeek(0);         // вернуться к началу
while ($row = $res->getAssoc()) { ... }

Шпаргалка «что вернуть»

Нужно	Метод
Список строк	`getAll()` (+ `?: array()`)
Одна строка (ассоц.)	`getAssoc()`
Одна строка (объект)	`getObject()`
Число/строка одним значением	`getValue()`
Самая первая ячейка	`getOne()`
Плоский список одного столбца	`DB::queryOneColumn()`

3.8 KiB Raw Permalink Blame History Unescape Escape

Чтение результата — DB_Result

Много строк

getAll()