method public

ConnectionPool::getSlaveConnection()

Сигнатура

public getSlaveConnection(string $sql) : Connection|null

Описание

Возвращает подчинённое (slave) соединение или null, если запрос должен идти к главному (master).

Параметры

$sql string

SQL-строка. Только SELECT будет направлен к подчинённому (slave).

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

Connection|null

Как применяется в ConnectionPool

ConnectionPool::getSlaveConnection() — метод класса \Bitrix\Main\Data\ConnectionPool модуля «Главный модуль». ConnectionPool: Пул соединений — это держатель соединений.

Метод объекта: сначала нужен экземпляр ConnectionPool.

use Bitrix\Main\Data\ConnectionPool;

/** @var ConnectionPool $object */
$sql = '';
$result = $object->getSlaveConnection($sql);
// $result: Connection|null

Другие методы ConnectionPool

cloneConnection() Создаёт новое соединение на основе предоставленного.
disconnect() Отключает все соединения с *базой данных*.
getConnection() Возвращает соединение с базой данных по его имени. Создаёт новое соединение при необходимости.
ignoreDml() В режиме игнорирования DML команда модификации данных не остановит направление следующих запросов к подчинённому…
isMasterOnly() Возвращает состояние балансировки запросов (можно ли использовать только главный сервер).
isSlavePossible() Возвращает состояние балансировки запросов (можно ли ещё использовать подчинённый сервер).
setConnectionParameters() Устанавливает параметры именованного соединения.
useMasterOnly() В режиме «только главный» (master-only) все запросы будут направляться к главному серверу.

Исходный файл: source/main/lib/data/connectionpool.php:159