MongoDB\GridFS\Bucket::__construct()

定义

MongoDB\GridFS\Bucket::__construct()

构造一个新的Bucket实例。

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

参数

$manager ： MongoDB\Driver\Manager

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

$databaseName ：字符串

数据库的名称。

$options : array

指定所需选项的数组。

名称	类型	说明
bucketName	字符串	存储桶名称，将用作文件和数据块collection的前缀。默认为"fs" 。
chunkSizeBytes	整型	数据段大小（以字节为单位）。 默认为261120 （即 255 KiB）。
编解码器	MongoDB\Codec\DocumentCodec	用于返回文件文档的存储桶方法的默认编解码器（例如MongoDB\GridFS\Bucket::find() ）。 1.17 版本中的新增功能。
禁用 MD5	布尔	存储文件时是否禁用自动生成 MD5。 默认为false 。 true仅支持2 。 0 。 1.4 版本中的新增功能。
readConcern	MongoDB\Driver\ReadConcern	用于存储桶操作的默认读关注（read concern）。默认为经理的读关注（read concern）。
readPreference	MongoDB\Driver\ReadPreference	用于存储桶操作的默认读取偏好（read preference）。默认为经理的读取偏好（read preference）。
typeMap	阵列	默认 类型映射 应用于游标，决定如何将 BSON 文档转换为 PHP 值。该库默认使用以下类型映射： [ 'array' => 'MongoDB\Model\BSONArray', 'document' => 'MongoDB\Model\BSONDocument', 'root' => 'MongoDB\Model\BSONDocument', ]
writeConcern	MongoDB\Driver\WriteConcern	用于存储桶操作的默认写关注。 默认为管理器的写关注。

错误/异常

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

行为

如果您显式构造存储桶，则该存储桶会继承 MongoDB\Driver\Manager 对象。如果您从Database 对象中选择存储桶，则存储桶将从该对象继承其选项。

举例

<?php
$bucket = (new MongoDB\Client)->test->selectGridFSBucket();
var_dump($bucket);

而输出将类似如下所示：

object(MongoDB\GridFS\Bucket)#3053 (2) {
  ["bucketName"]=>
  string(4) "test"
  ["databaseName"]=>
  string(11) "phplib_test"
}

另请参阅

• MongoDB\Database::selectGridFSBucket()