MongoDB\GridFS\Bucket::openUploadStream()

本页内容

定义

参数
返回值
行为
示例
另请参阅

定义

MongoDB\GridFS\Bucket::openUploadStream()

打开一个可写流，用于创建新的GridFS文件。

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

参数

$filename : string

要创建的文件的名称。

$options : array

指定所需选项的数组。

名称	类型	描述
_id	mixed	用作文件文档标识符的值。默认为新MongoDB\BSON\ObjectId 对象。
chunkSizeBytes	整数	数据块大小（以字节为单位）。默认值为存储桶的 `chunkSizeBytes` 选项。
disableMD5	布尔值	是否在存储文件时禁用自动MD5生成。默认为 `false`。2.0版本中仅支持 `true`。新功能自版本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()

openDownloadStreamByName()

registerGlobalStreamWrapperAlias()