MongoDB\GridFS\Bucket::downloadToStreamByName()

Definição

MongoDB\GridFS\Bucket::downloadToStreamByName()

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

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

Parâmetros

$filename : string

O filename do arquivo a ser baixado.

$destination : recurso

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

$options : array

Um array especificando as opções desejadas.

Nome	Tipo	Descrição
revisão	inteiro	A revisão do arquivo a ser recuperado. Arquivos com o mesmo filename serão diferenciados pelo campo uploadDate . Os números de revisão são definidos da seguinte forma: 0 = o arquivo original armazenado 1 = a primeira revisão 2 = a segunda revisão etc... -2 = a segunda revisão mais recente -1 = a revisão mais recente O padrão é -1 (ou seja, a revisão mais recente).

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 do driver (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);
$bucket->uploadFromStream('filename', $stream);
$destination = fopen('php://temp', 'w+b');
$bucket->downloadToStreamByName('filename', $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::downloadToStream()

• MongoDB\GridFS\Bucket::openDownloadStream()

• MongoDB\GridFS\Bucket::openDownloadStreamByName()