Задать соединение SqlExpression::setConnection
Модуль: main — подключать отдельно не нужно
Метод SqlExpression::setConnection задает соединение, по правилам которого метод compile экранирует значения. Если метод не вызван, выражение использует соединение по умолчанию.
Задайте соединение, если запрос с выражением выполняет другое соединение. В MySQL и PostgreSQL отличаются кавычки идентификаторов и результат плейсхолдера ?v.
Сигнатура метода в классе Bitrix\Main\DB\SqlExpression:
public function setConnection($connection)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| connection* | Bitrix\Main\DB\Connection, null |
Задает соединение, по правилам которого метод compile экранирует значения. Значение null сбрасывает соединение, и следующий вызов getConnection вернет соединение по умолчанию |
Типы в таблице описывают назначение аргумента. Сигнатура PHP не объявляет их.
Возвращаемое значение
Метод ничего не возвращает.
Примеры
Пример. Код проверяет, есть ли колонка в таблице. Выражение экранирует имена по правилам того же соединения, которое выполняет запрос. Для другой базы данных подставьте имя ее соединения.
<?php
use Bitrix\Main\Application;
use Bitrix\Main\DB\SqlExpression;
use Bitrix\Main\DB\SqlQueryException;
use Bitrix\Main\UserTable;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
// Имя соединения из секции connections файла .settings.php
$connection = Application::getConnection('default');
$expression = new SqlExpression('SELECT ?# FROM ?# WHERE 1 = 0', 'LOGIN', UserTable::getTableName());
$expression->setConnection($connection);
try
{
$connection->query($expression->compile());
echo 'Column exists';
}
catch (SqlQueryException $exception)
{
echo 'Column not found';
}