SqlExpression — SQL-выражение с плейсхолдерами

Пространство имен: Bitrix\Main\DB

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

Доступно с версии: 14.0.0

Когда использовать

Класс SqlExpression хранит шаблон SQL-фрагмента и значения для его плейсхолдеров. Метод compile подставляет значения в шаблон и экранирует их через SqlHelper соединения.

Объект SqlExpression подходит там, где нужен SQL-фрагмент, а не скалярное значение. ORM принимает объект как значение поля, например CNT + 1. Объект можно передать в Connection::query вместо строки запроса, метод приводит его к строке.

Чтобы экранировать одно значение без шаблона, используйте методы SqlHelper::forSql и SqlHelper::quote.

Методы класса

Метод Описание С версии
__construct Создает выражение из шаблона и значений для плейсхолдеров
compile Возвращает SQL-фрагмент с подставленными и экранированными значениями
getConnection Возвращает соединение, по правилам которого метод compile экранирует значения
setConnection Задает соединение, по правилам которого метод compile экранирует значения

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

Предыдущая
Следующая