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选项。
禁用 MD5	布尔	存储文件时是否禁用自动生成 MD5。 默认为false 。 true仅支持2 。 0 。 1.4 版本中的新增功能。
元数据	数组|对象	文件文档metadata字段的用户数据。如果未指定，则不会在文件文档上设置metadata字段。

返回值

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

错误/异常

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

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

举例

<?php
$bucket = (new MongoDB\Client)->test->selectGridFSBucket();
$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()