MongoDB\Driver\Manager::selectServer

(mongodb >=1.0.0)

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

Description

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.

Note: 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.

Liste de paramètres

readPreference (MongoDB\Driver\ReadPreference): The read preference to use for selecting a server.

Valeurs de retour

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

Erreurs / Exceptions

Lance une exception MongoDB\Driver\AuthenticationException si une identification est nécessaire mais qu'elle échoue
Lance une exception MongoDB\Driver\ConnectionException si la connexion au serveur échoue pour une autre raison qu'en raison d'un problème d'identification
Throws MongoDB\Driver\Exception\RuntimeException if a server matching the read preference could not be found.

Voir aussi

MongoDB\Driver\Server
MongoDB\Driver\Manager::getServers() - Retourner les serveurs auxquels ce gestionnaire est connecté
» Server Selection Specification