Склеить строки в SQL SqlHelper::getConcatFunction

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

Метод SqlHelper::getConcatFunction возвращает SQL-выражение, которое склеивает колонки и выражения в одну строку. Аналог в классическом API — CDatabase::Concat, он вызывает этот метод.

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

abstract public function getConcatFunction();

Метод читает аргументы через func_get_args(), поэтому в сигнатуре параметров нет.

Параметры

Параметр Тип Описание
...fields string Задают колонки или SQL-выражения, каждое отдельным аргументом. Строковые значения передавайте экранированными и в кавычках. Метод подставляет аргументы в SQL без экранирования

Типы в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.

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

Метод возвращает строку string — SQL-выражение.

Реализация Выражение
MysqliSqlHelper CONCAT(<a>, <b>, ...). Без аргументов — пустая строка
PgsqlSqlHelper <a> || <b> || .... Без аргументов — пустая строка

Примеры

Пример. Код выбирает имя и фамилию пользователя одной колонкой:

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

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

$connection = Application::getConnection();
$helper = $connection->getSqlHelper();

echo $connection->queryScalar(
    'SELECT ' . $helper->getConcatFunction('NAME', "' '", 'LAST_NAME')
    . ' FROM ' . $helper->quote(UserTable::getTableName()) . ' ORDER BY ID'
);

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