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