MongoDB\GridFS\Bucket::openDownloadStreamByName()

本页面

定义

参数
返回值
错误/异常
示例
另请参阅

定义

MongoDB\GridFS\Bucket::openDownloadStreamByName()

通过文件的filename选择GridFS文件，并以可读流的形式打开。

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

参数

$filename : 字符串

要下载的文件的filename。

$options : 数组

指定所需选项的数组。

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

返回值

可读的流资源。

错误/异常

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

MongoDB\Driver\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"

参见

openDownloadStream()

openUploadStream()