MongoDB\Driver\Manager::selectServer

Select a server matching a read preference

&reftitle.description; final public `MongoDB\Driver\Server` `MongoDB\Driver\Manager::selectServer` ``MongoDB\Driver\ReadPreference``null```readPreference`&null;

Selects a `MongoDB\Driver\Server` matching `readPreference`. If `readPreference` is &null; or omitted, the primary server will be selected by default. 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.

&reftitle.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.

&reftitle.returnvalues;

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

&reftitle.errors;

&mongodb.throws.std;
- Throws `MongoDB\Driver\Exception\RuntimeException` if a server matching the read preference could not be found.

&reftitle.changelog;

&Version; | &Description;
PECL mongodb 1.11.0 | The `readPreference` is now optional. If &null; or omitted, the primary server will be selected by default.

&reftitle.seealso;

- `MongoDB\Driver\Server`
- `MongoDB\Driver\Manager::getServers`
- Server Selection Specification