MongoDB\GridFS\Bucket::openUploadStream()

Definición

MongoDB\GridFS\Bucket::openUploadStream()

Abre una secuencia de escritura para un nuevo archivo GridFS.

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

Parámetros

$filename : cadena

El filename del archivo a crear.

$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

Un recurso de flujo que se puede escribir.

Comportamiento

Los documentos fragmentados se crearán a medida que se escriban datos en el flujo de escritura. El documento de metadatos se creará al cerrar 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));

El resultado sería entonces similar a lo siguiente:

string(6) "foobar"

Ver también

• MongoDB\GridFS\Bucket::uploadFromStream()