Присвоить значение с проверкой хеша SqlHelper::getConditionalAssignment

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

Метод SqlHelper::getConditionalAssignment возвращает выражение CASE для правой части присваивания в UPDATE. Если хеш SHA-1 текущего значения колонки совпадает с хешем нового значения, выражение оставляет текущее значение. Иначе выражение возвращает новое значение.

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

public function getConditionalAssignment($field, string $value): string

Параметры

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

Параметр Тип Описание
field* string, SqlExpression Задает колонку. Строку метод берет в кавычки через quote, объект SqlExpression подставляет собранным
value* string Задает новое значение. Метод экранирует его и берет в кавычки

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

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

Метод возвращает строку string вида case when <sha1(field)> = '<sha1(value)>' then <field> else '<value>' end. Функцию хеша метод получает из getSha1Function.

Исключения

Исключение Когда возникает
Bitrix\Main\DB\ConnectionException Подключиться к базе данных для экранирования не удалось
Bitrix\Main\ArgumentException В field передан объект SqlExpression с ошибкой в значении для плейсхолдера ?@

Примеры

Пример. Код выводит выражение для колонки TITLE:

<?php
use Bitrix\Main\Application;

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

echo Application::getConnection()->getSqlHelper()->getConditionalAssignment('TITLE', 'Kilogram');

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