MongoDB\GridFS\Bucket::openDownloadStreamByName()

定义

MongoDB\GridFS\Bucket::openDownloadStreamByName()

通过filename选择 GridFS 文件并将其作为可读流打开。

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

参数

$filename ： 细绳

要下载的文件的filename 。

$options : array

指定所需选项的数组。

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

Return Values

可读的流资源。

错误/异常

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

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);
var_dump(stream_get_contents($bucket->openDownloadStreamByName('filename')));

而输出将类似如下所示：

string(6) "foobar"

另请参阅

• MongoDB\GridFS\Bucket::downloadToStream()

• MongoDB\GridFS\Bucket::downloadToStreamByName()

• MongoDB\GridFS\Bucket::openDownloadStream()