Сослаться на значение добавляемой строки SqlHelper::values

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

Метод SqlHelper::values возвращает ссылку на значение колонки из строки, которую добавляет запрос. Ссылка нужна в части обновления запроса вставки, если строка с таким ключом уже есть. Плейсхолдер ?v объекта SqlExpression вызывает этот метод.

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

public function values($identifier)

Параметры

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

Параметр Тип Описание
identifier* string Задает имя колонки. Метод берет его в кавычки через quote

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

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

Метод возвращает строку string.

Реализация Значение
MysqliSqlHelper VALUES(`<identifier>`) для ON DUPLICATE KEY UPDATE
PgsqlSqlHelper EXCLUDED."<identifier>" для ON CONFLICT ... DO UPDATE. Имя колонки метод приводит к нижнему регистру

Исключения

Исключение Когда возникает
Bitrix\Main\DB\ConnectionException В PostgreSQL подключиться к базе данных не удалось
Bitrix\Main\NotImplementedException Соединение работает не с MySQL и не с PostgreSQL. Базовый класс не реализует метод

Примеры

Пример. Код выводит выражение, которое увеличивает счетчик на значение из добавляемой строки:

<?php
use Bitrix\Main\Application;

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

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

echo $helper->quote('CNT') . ' = ' . $helper->quote('CNT') . ' + ' . $helper->values('CNT');

Для MySQL код выведет `CNT` = `CNT` + VALUES(`CNT`).

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