MongoDB\Collection::__construct()

定义

MongoDB\Collection::__construct()

构造一个新的 Collection实例。

function __construct(
    MongoDB\Driver\Manager $manager,
    string $databaseName,
    string $collectionName,
    array $options = []
)

此构造函数具有以下参数：

$manager ： MongoDB\Driver\Manager

经理 实例。管理器维护驱动程序和 MongoDB 实例之间的连接。

$databaseName ： 细绳

数据库的名称。

$collectionName ： 细绳

集合的名称。

$options : array

指定所需选项的数组。

名称	类型	说明
builderEncoder	MongoDB\Codec\Encoder	用于查询和聚合构建者的编码器。如果未设立，此选项默认为 MongoDB\Builder\BuilderEncoder 类的新实例。 1.21版本新增。
编解码器	MongoDB\Codec\DocumentCodec	用于集合操作的默认编解码器。 1.17 版本中的新增功能。
事务外的	MongoDB\Driver\ReadConcern	用于collection操作的默认读关注（read concern）。默认为经理的读关注（read concern）。
readPreference	MongoDB\Driver\ReadPreference	用于collection操作的默认读取偏好（read preference）。默认为经理的读取偏好（read preference）。
typeMap	阵列	默认 类型映射 应用于游标，决定如何将 BSON 文档转换为 PHP 值。该库默认使用以下类型映射： [ 'array' => 'MongoDB\Model\BSONArray', 'document' => 'MongoDB\Model\BSONDocument', 'root' => 'MongoDB\Model\BSONDocument', ]
writeConcern	MongoDB\Driver\WriteConcern	用于collection操作的默认写关注（write concern）。默认为管理器的写关注。

错误/异常

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

行为

如果显式构造集合，则该集合会继承 MongoDB\Driver\Manager 中的任何选项 对象。如果您从Client或Database对象中选择集合，则集合将从该对象继承其选项。

另请参阅

• MongoDB\Collection::withOptions()

• MongoDB\Client::selectCollection()

• MongoDB\Database::selectCollection()

• MongoDB\Database::__get()