MongoDB\GridFS\Bucket::downloadToStreamByName()

Definición

MongoDB\GridFS\Bucket::downloadToStreamByName()

Selecciona un archivo GridFS por su filename y copia su contenido a una secuencia escribible.

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

Parámetros

$filename : cadena

El filename del archivo a descargar.

$destination : resource

Flujo escribible en el que se escribirán los contenidos del archivo GridFS.

$options : matriz

Una matriz que especifica las opciones deseadas.

Nombre	Tipo	Descripción
revisión	entero	La revisión del archivo a recuperar. Los archivos con el mismo filename se diferenciarán por su campo uploadDate. Los números de revisión se definen de la siguiente manera: 0 = el archivo original almacenado 1 = la primera revisión 2 = la segunda revisión etc... -2 = la segunda revisión más reciente -1 = la revisión más reciente Por defecto, -1 (es decir, la revisión más reciente).

Errores/Excepciones

MongoDB\GridFS\Exception\FileNotFoundException si no se encontró ningún archivo para los criterios de selección.

MongoDB\Exception\InvalidArgumentException para errores relacionados con el análisis de parámetros u opciones.

MongoDB\Controlador\Excepción\Excepción de tiempo de ejecución para otros errores a nivel de extensión (por ejemplo errores de conexión).

Ejemplos

<?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));

El resultado sería entonces similar a lo siguiente:

string(6) "foobar"

Ver también

• MongoDB\GridFS\Bucket::downloadToStream()

• MongoDB\GridFS\Bucket::openDownloadStream()

• MongoDB\GridFS\Bucket::openDownloadStreamByName()