MongoDB\Driver\Manager::selectServer
Select a server matching a read preference
Description
final public MongoDB\Driver\Server MongoDB\Driver\Manager::selectServer(MongoDB\Driver\ReadPreferencenull $readPreference
= null
)
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.
Parameters
-
readPreference
(MongoDB\Driver\ReadPreference)
-
The read preference to use for selecting a server. If null
or omitted,
the primary server will be selected by default.
Return Values
Returns a MongoDB\Driver\Server matching the read
preference.
Errors/Exceptions
- Throws MongoDB\Driver\Exception\InvalidArgumentException on argument parsing errors.
- Throws MongoDB\Driver\Exception\ConnectionException if connection to the server fails (for reasons other than authentication).
- Throws MongoDB\Driver\Exception\AuthenticationException if authentication is needed and fails.
- Throws MongoDB\Driver\Exception\RuntimeException if a server matching the read preference could not be found.