MongoDB\Client::getDatabase()

定义

MongoDB\Client::getDatabase()

获取对服务器上数据库的访问权限。此方法是 MongoDB\Client::selectDatabase() 的别名，并将在未来发布中取代它。

function getDatabase(
    string $databaseName,
    array $options = []
): MongoDB\Database

参数

$databaseName ： 细绳

要访问的数据库名称。

$options : array

指定所需选项的数组。

名称	类型	说明
事务外的	MongoDB\Driver\ReadConcern	用于数据库操作的默认读关注（read concern）。默认为客户端的读关注（read concern）。
readPreference	MongoDB\Driver\ReadPreference	用于数据库操作的默认读取偏好（read preference）。默认为客户端的读取偏好（read preference）。
typeMap	阵列	用于数据库操作的默认类型映射。 默认为客户端的类型映射。
writeConcern	MongoDB\Driver\WriteConcern	用于数据库操作的默认写关注（write concern）。Defaults to the client's write concern.

Return Values

一个MongoDB\Database对象。

错误/异常

MongoDB\Exception\InvalidArgumentException 用于与参数或选项解析相关的错误。

行为

所选数据库会从 Client 对象继承读取偏好（read preference）和类型映射等选项。可以使用 $options 参数覆盖选项。

例子

以下示例获取对 test数据库的访问权限：

<?php
$client = new MongoDB\Client;
$db = $client->getDatabase('test');

以下示例使用自定义读取偏好（read preference）访问权限test数据库：

<?php
$client = new MongoDB\Client;
$db = $client->getDatabase(
    'test',
    [
        'readPreference' => new MongoDB\Driver\ReadPreference('primaryPreferred'),
    ]
);

另请参阅

• MongoDB\Client::__get()

• MongoDB\Database::__construct()