MongoDB\Client::selectDatabase()

本页内容

定义

参数
返回值
错误/异常
行为
示例
另请参阅

定义

MongoDB\Client::selectDatabase()

在服务器上选择数据库。

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

参数

$databaseName : 字符串

要选择的数据库的名称。

$options : 数组

指定所需选项的数组。

名称	类型	描述
readConcern	MongoDB\Driver\ReadConcern	数据库操作默认的读取关注点。默认为客户端的读取关注点。
readPreference	MongoDB\Driver\ReadPreference	数据库操作默认的读取偏好。默认为客户端的读取偏好。
typeMap	数组	数据库操作默认的类型映射。默认为客户端的类型映射。
writeConcern	MongoDB\Driver\WriteConcern	数据库操作默认的写入关注点。默认为客户端的写入关注点。

返回值

AMongoDB\Database 对象。

错误/异常

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

行为

所选数据库从Client对象继承读取首选项和类型映射等选项。可以通过$options参数覆盖选项。

示例

以下示例选择test数据库

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

以下示例选择具有自定义读取首选项的test数据库

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

另请参阅

selectCollection()

startSession()