MongoDB\Driver\Manager::selectServer
(mongodb >=1.0.0)
MongoDB\Driver\Manager::selectServer — Выбрать сервер, соответствующий предпочтениям чтения
Описание
$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() - Возвращает серверы, к которым подключён менеджер
- » Спецификация выбора сервера
add a note
