MongoDB\GridFS\Bucket::uploadFromStream()

定义

MongoDB\GridFS\Bucket::uploadFromStream()

创建新的 GridFS 文件并将可读流的内容复制到其中。

function uploadFromStream(    string $filename,    resource $source,    array $options = []): mixed

参数

$filename ： 细绳

要创建的文件的filename 。

$source ：资源

可读流，将从中读取新 GridFS 文件的内容。

$options : array

指定所需选项的数组。

名称	类型	说明
_id	混合	用作文件文档标识符的值。默认为新的MongoDB\BSON\ObjectId对象。
chunkSizeBytes	整型	数据段大小（以字节为单位）。 默认为存储桶的chunkSizeBytes选项。
metadata	数组|对象	文件文档metadata字段的用户数据。如果未指定，则不会在文件文档上设置metadata字段。

Return Values

与新创建的GridFS文件关联的元数据文档的 _id字段。如果未指定 _id 选项，则默认使用新的MongoDB\BSON\ObjectId对象。

错误/异常

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

MongoDB\ 驱动程序\Exception\RuntimeException 用于扩展级别的其他错误（例如连接错误）。

示例

<?php
$bucket = (new MongoDB\Client)->test->getGridFSBucket();
$stream = fopen('php://temp', 'w+b');fwrite($stream, "foobar");rewind($stream);
$id = $bucket->uploadFromStream('filename', $stream);
var_dump($id);

而输出将类似如下所示：

object(MongoDB\BSON\ObjectId)#3009 (1) {  ["oid"]=>  string(24) "5acf81017e21e816e538d883"}

另请参阅

• MongoDB\GridFS\Bucket::openUploadStream()