Menu Docs
Página inicial do Docs
/ / /
Manual da Biblioteca PHP
/ /

MongoDB\GridFS\Bucket::openDownloadStreamByName()

Nesta página

  • Definição
  • Parâmetros
  • Return Values
  • Erros/exceções
  • Exemplos
  • Veja também
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
$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).

Um recurso de fluxo legível.

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

<?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"

Voltar

OpenDownloadStream()