MongoDB\GridFS\Bucket::downloadToStreamByName()

定义

MongoDB\GridFS\Bucket::downloadToStreamByName()

通过filename选择 GridFS 文件，并将其内容复制到可写流。

function downloadToStreamByName(
    string $filename,
    resource $destination,
    array $options = []
): void

参数

$filename ： 细绳

要下载的文件的filename 。

$destination ：资源

可写入流，GridFS 文件内容将写入其中。

$options : array

指定所需选项的数组。

名称	类型	说明
修订	整型	要检索的文件的修订版本。 具有相同filename的文件将通过其uploadDate字段进行区分。 修订号定义如下： 0 = 原始存储的文件 1 = 第一个修订 2 = 第二个修订版 等等... -2 = 第二个最新修订版本 -1 = 最新版本 默认为 -1（即最新修订版）。

错误/异常

MongoDB\GridFS\Exception\FileNotFoundException 如果未找到符合选择条件的文件。

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

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

示例

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

而输出将类似如下所示：

string(6) "foobar"

另请参阅

• MongoDB\GridFS\Bucket::downloadToStream()

• MongoDB\GridFS\Bucket::openDownloadStream()

• MongoDB\GridFS\Bucket::openDownloadStreamByName()