Задать функции преобразования Result::setConverters
Модуль: main — подключать отдельно не нужно
Метод Result::setConverters заменяет функции, которыми fetch преобразует значения колонок. Метод заменяет весь список, а не добавляет функции к нему.
Сигнатура метода в классе Bitrix\Main\DB\Result:
public function setConverters($converters)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| converters* | callable[] |
Задает функции в виде имя колонки => функция. Функция принимает значение колонки и возвращает новое значение. Пустой массив отключает преобразования, в том числе дат |
Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.
Возвращаемое значение
Метод ничего не возвращает.
Колонка из списка должна быть в каждой строке результата. Метод fetch передает функции значение $data[имя колонки] без проверки.
Примеры
Пример. Код добавляет к стандартным преобразованиям функцию, которая приводит логин к верхнему регистру:
<?php
use Bitrix\Main\Application;
use Bitrix\Main\UserTable;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$result = Application::getConnection()->query(
'SELECT LOGIN, DATE_REGISTER FROM ' . UserTable::getTableName() . ' ORDER BY ID',
1
);
$converters = $result->getConverters();
$converters['LOGIN'] = static fn($value) => mb_strtoupper($value);
$result->setConverters($converters);
$row = $result->fetch();
echo $row['LOGIN'] . ' ' . get_class($row['DATE_REGISTER']);
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая