MongoDB\GridFS\Bucket::downloadToStream()

Definição

MongoDB\GridFS\Bucket::downloadToStream()

Seleciona um arquivo GridFS por seu _id e copia seu conteúdo para um fluxo gravável.

function downloadToStream($id, $destination): void

Parâmetros

$id : misto

O _id do arquivo a ser baixado.

$destination : recurso

Fluxo gravável, no qual o conteúdo do arquivo GridFS será gravado.

Erros/exceções

MongoDB\GridFS\Exception\FileNotFoundException se nenhum arquivo tiver sido encontrado para os critérios de seleção.

MongoDB\Exception\InvalidArgumentException para erros relacionados à análise de parâmetros ou opções.

MongoDB\Driver\Exception\RuntimeException para outros erros no nível da extensão (por exemplo erros de conexão).

Exemplos

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

A saída seria então semelhante a:

string(6) "foobar"

Veja também

• MongoDB\GridFS\Bucket::downloadToStreamByName()

• MongoDB\GridFS\Bucket::openDownloadStream()

• MongoDB\GridFS\Bucket::openDownloadStreamByName()