MongoDB\Driver\Manager::selectServer

(mongodb >=1.0.0)

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

Descripción

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.

Parámetros

readPreference (MongoDB\Driver\ReadPreference): Opcionalmente, un MongoDB\Driver\ReadPreference para seleccionar el servidor para esta operación. Si no se proporciona, se usará la preferencia de lectura del URI de conexión de MongoDB.

Valores devueltos

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

Errores/Excepciones

Lanza una MongoDB\Driver\Exception\InvalidArgumentException en errores de análisis de argumentos.
Lanza una MongoDB\Driver\Exception\ConnectionException si la conexión al servidor falla (por razones diferentes a la autenticación).
Lanza una MongoDB\Driver\Exception\AuthenticationException si la autenticación es necesaria y falla.
Throws MongoDB\Driver\Exception\RuntimeException if a server matching the read preference could not be found.

Ver también

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