MongoDB\Driver\Manager::selectServer

(mongodb >=1.0.0)

MongoDB\Driver\Manager::selectServer — Select a server matching a read preference

Описание

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

Selects a MongoDB\Driver\Server matching readPreference. This may be used to preselect a server in order to perform version checking before executing an operation.

Замечание:
Unlike MongoDB\Driver\Manager::getServers(), this method will initialize database connections and perform server discovery if necessary. See the » Server Selection Specification for additional information.

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

readPreference (MongoDB\Driver\ReadPreference): Опционально MongoDB\Driver\ReadPreference для выбора сервера для этой операции. Если не задано, то он будет выбран из URI соединения MongoDB.

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

Returns an MongoDB\Driver\Server matching the read preference.

Ошибки

При ошибке парсинга аргумента бросает исключение MongoDB\Driver\Exception\InvalidArgumentException.
При неудачном соединении с сервером (кроме ошибок аутентификации), бросает исключение MongoDB\Driver\Exception\ConnectionException.
При неудачной аутентификации бросает исключение MongoDB\Driver\Exception\AuthenticationException.
Throws MongoDB\Driver\Exception\RuntimeException if a server matching the read preference could not be found.

Смотрите также

MongoDB\Driver\Server
MongoDB\Driver\Manager::getServers() - Return the servers to which this manager is connected
» Server Selection Specification