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

Una matriz que especifica las opciones deseadas.

Nombre	Tipo	Descripción
_id	mixto	Valor que se utilizará como identificador del documento de archivo. Se configura por defecto a 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 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));

La vista de salida se ilustraría como sigue:

string(6) "foobar"

Ver también

• MongoDB\GridFS\Bucket::uploadFromStream()