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. 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.
disableMD5	booleano	Indica si se debe deshabilitar la generación automática de MD5 al almacenar archivos. Por defecto es false. Solo true será soportado en 2.0. Nuevo en la versión 1.4.
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()