MongoDB\GridFS\Bucket::openUploadStream()

定义

MongoDB\GridFS\Bucket::openUploadStream()

打开新 GridFS 文件的可写流。

function openUploadStream(
    string $filename,
    array $options = []
): resource

参数

$filename ： 细绳

要创建的文件的filename 。

$options : array

指定所需选项的数组。

名称	类型	说明
_id	混合	用作文件文档标识符的值。默认为新的 MongoDB\BSON\ObjectId 对象。
chunkSizeBytes	整型	数据段大小（以字节为单位）。 默认为存储桶的chunkSizeBytes选项。
禁用 MD5	布尔	存储文件时是否禁用自动生成 MD5。 默认为false 。 true仅支持2 。 0 。 1.4 版本中的新增功能。
元数据	数组|对象	文件文档metadata字段的用户数据。如果未指定，则不会在文件文档上设置metadata字段。

返回值

可写流资源。

行为

当数据写入可写流时，将创建数据块文档。当可写流关闭时，将创建元数据文档。

举例

<?php
$bucket = (new MongoDB\Client)->test->selectGridFSBucket();
$uploadStream = $bucket->openUploadStream('filename');
fwrite($uploadStream, 'foobar');
fclose($uploadStream);
$downloadStream = $bucket->openDownloadStreamByName('filename');
var_dump(stream_get_contents($downloadStream));

而输出将类似如下所示：

string(6) "foobar"

另请参阅

• MongoDB\GridFS\Bucket::uploadFromStream()