MongoDB\GridFS\Bucket::openDownloadStreamByName()

Definição

MongoDB\GridFS\Bucket::openDownloadStreamByName()

Seleciona um arquivo GridFS pelo seu filename e abre como um fluxo legível.

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

Parâmetros

$filename : string

O filename do arquivo a ser baixado.

$options : array

Uma 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).

Return Values

Um recurso de fluxo legível.

Erros/exceções

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

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

A saída seria então semelhante a:

string(6) "foobar"

Veja também

• MongoDB\GridFS\Bucket::downloadToStream()

• MongoDB\GridFS\Bucket::downloadToStreamByName()

• MongoDB\GridFS\Bucket::openDownloadStream()