Присвоить значение с проверкой хеша 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');
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая