Задать переименование колонок Result::setReplacedAliases

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

Метод Result::setReplacedAliases задает переименование колонок. Метод fetch вернет колонку под новым именем. Метод вызывает DB\Result::setReplacedAliases.

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

public function setReplacedAliases(array $replacedAliases)

Параметры

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

Параметр Тип Описание
replacedAliases* array Задает переименование в виде имя в запросе => имя в строке

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

Метод ничего не возвращает.

Особенности

  • Если псевдоним поля длиннее, чем допускает база данных, запрос сокращает его до вида FALIAS_0 и сам задает переименование у внутреннего результата.
  • Метод заменяет это переименование. Если запрос сократил псевдонимы, после вызова fetch вернет колонки под сокращенными именами. Чтобы дополнить список, используйте addReplacedAliases.

Примеры

Пример. Код возвращает колонку LID под именем CODE:

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

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

$result = LanguageTable::getList(['select' => ['LID'], 'filter' => ['=LID' => 'en']]);
$result->setReplacedAliases(['LID' => 'CODE']);

var_export($result->fetch());

Код выведет:

array (
  'CODE' => 'en',
)

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