MongoDB\GridFS\Bucket::openUploadStream()

Definición

MongoDB\GridFS\Bucket::openUploadStream()

Abre un flujo de escritura para un nuevo archivo GridFS.

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

Parámetros

$filename : string

El filename del archivo para crear.

$options : arreglo

Un arreglo que especifica las opciones deseadas.

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

Return Values

Un recurso de flujo escribible.

Comportamiento

Los documentos fragmentos se crearán a medida que se escriban los datos en el stream de escritura. El documento de metadatos se creará cuando se cierre el flujo de escritura.

Ejemplos

<?php
$bucket = (new MongoDB\Client)->test->selectGridFSBucket();
$uploadStream = $bucket->openUploadStream('filename');
fwrite($uploadStream, 'foobar');
fclose($uploadStream);
$downloadStream = $bucket->openDownloadStreamByName('filename');
var_dump(stream_get_contents($downloadStream));

La vista de salida se ilustraría como sigue:

string(6) "foobar"

Ver también

• MongoDB\GridFS\Bucket::uploadFromStream()