Получить строку без преобразований Result::fetchRaw

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

Доступно с версии: 15.5.1

Метод Result::fetchRaw возвращает следующую строку результата без преобразований, которые выполняет fetch. Метод оставляет даты строками, не десериализует значения и не переименовывает колонки.

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

public function fetchRaw()

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

Метод возвращает массив имя колонки => значение или false, если строк больше нет.

Строку готовит реализация результата.

Реализация Строка
MysqliResult Строка mysqli без изменений
PgsqlResult Ключи в верхнем регистре. Значения колонок типа bytea раскодированы функцией pg_unescape_bytea

Если код включил отслеживание через Connection::startTracker, метод добавляет время выборки и размер строки в сведения о запросе.

Примеры

Пример. Код сравнивает дату регистрации из fetchRaw и fetch. В первом случае это строка, во втором — объект:

<?php
use Bitrix\Main\Application;
use Bitrix\Main\UserTable;

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

$connection = Application::getConnection();
$sql = 'SELECT DATE_REGISTER FROM ' . UserTable::getTableName() . ' ORDER BY ID';

$raw = $connection->query($sql, 1)->fetchRaw();
$converted = $connection->query($sql, 1)->fetch();

echo gettype($raw['DATE_REGISTER']) . ' / ' . get_class($converted['DATE_REGISTER']);

Код выведет string / Bitrix\Main\Type\DateTime.

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