MongoDB\Driver\Manager::selectServer

(mongodb >=1.0.0)

MongoDB\Driver\Manager::selectServer — Вибрати сервер, який відповідає перевагам читання

Опис

final public MongoDB\Driver\Manager::selectServer(?MongoDB\Driver\ReadPreference $readPreference = null): MongoDB\Driver\Server

Вибирає MongoDB\Driver\Server, соответствующийreadPreference. Якщо параметр readPreferenceравен**null** або опущено, за промовчанням буде обрано первинний сервер. Це можна використовувати для попереднього вибору сервера, щоб перевірити версію перед виконанням операції.

Зауваження: В отличие отMongoDB\Driver\Manager::getServers(), цей метод ініціалізуватиме підключення до бази даних і при необхідності виконувати виявлення сервера. Детальніше дивіться . » Специфікацію вибору сервера

Список параметрів

readPreference MongoDB\Driver\ReadPreference) .

Перевага читання використовується для вибору сервера. Якщо null або опущено, за промовчанням буде обрано первинний сервер.

Значення, що повертаються

Повертає MongoDB\Driver\Server, Що відповідає перевагу читання.

Помилки

При помилці парсингу аргумент кидає винятокMongoDB\Driver\Exception\InvalidArgumentException
При невдалому з'єднанні з сервером (крім помилок аутентифікації) кидає винятокMongoDB\Driver\Exception\ConnectionException
У разі невдалої аутентифікації кидає винятокMongoDB\Driver\Exception\AuthenticationException
При неможливості знайти сервер, що відповідає перевагу читання, викидає винятокMongoDB\Driver\Exception\RuntimeException

список змін

Версия	Опис
PECL mongodb 1.11.0	Параметр`readPreference` тепер необов'язковий. Якщо вказано значення `null` або опущено, за промовчанням буде обрано первинний сервер.

Дивіться також

MongoDB\Driver\Server
MongoDB\Driver\Manager::getServers() - Повертає сервери, до яких підключено менеджера
» Специфікація вибору сервера