MongoDB\GridFS\Bucket::uploadFromStream()

Definición

MongoDB\GridFS\Bucket::uploadFromStream()

Crea un nuevo archivo GridFS y copia el contenido de una secuencia legible en él.

function uploadFromStream(
    string $filename,
    resource $source,
    array $options = []
): mixed

Parámetros

$filename : cadena

El filename del archivo a crear.

$source : resource

Flujo legible desde el cual se leerán los contenidos del nuevo archivo GridFS.

$options : matriz

Una matriz que especifica las opciones deseadas.

Nombre	Tipo	Descripción
_id	mixto	Valor que se utilizará como identificador del documento del archivo. El valor predeterminado es un nuevo MongoDB\BSON\ObjectId objeto.
bytes de tamaño de fragmento	entero	Tamaño del fragmento en bytes. El valor predeterminado es la opción chunkSizeBytes del depósito.
metadata	matriz|objeto	Datos de usuario para el campo metadata del documento de archivo. Si no se especifica, el campo metadata no se establecerá en el documento de archivo.

Return Values

El campo _id del documento de metadatos asociado con el archivo GridFS recién creado. Si no se especifica la opción _id, se usará de forma por defecto un nuevo objeto MongoDB\BSON\ObjectId.

Errores/Excepciones

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

MongoDB\Driver\Exception\RuntimeException para otros errores en el 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);
$id = $bucket->uploadFromStream('filename', $stream);
var_dump($id);

El resultado sería entonces similar a lo siguiente:

object(MongoDB\BSON\ObjectId)#3009 (1) {
  ["oid"]=>
  string(24) "5acf81017e21e816e538d883"
}

Ver también

• MongoDB\GridFS\Bucket::openUploadStream()