MongoDB\GridFS\Bucket::openUploadStream()

Definição

MongoDB\GridFS\Bucket::openUploadStream()

Abre um fluxo gravável para um novo arquivo GridFS.

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

Parâmetros

$filename : string

O filename do arquivo a ser criado.

$options : array

Uma array especificando as opções desejadas.

Nome	Tipo	Descrição
_id	misto	Valor a ser usado como identificador do documento de arquivo. O padrão é um novo MongoDB\BSON\ObjectId evento.
chunkSizeBytes	inteiro	O tamanho da parte em bytes. O padrão é a opção chunkSizeBytes do bucket.
disableMD5	booleano	Se a geração automática de md5 deve ser desabilitada ao armazenar arquivos. Padrão é false. Somente true será suportado em 2.0. Novidade na versão 1.4.
metadata	array|object	Dados do usuário para o campo metadata do documento de arquivo. Se não for especificado, o campo metadata não será definido no documento do arquivo.

Return Values

Um recurso de fluxo gravável.

Comportamento

Documentos em blocos serão criados à medida que os dados forem gravados no fluxo gravável. O documento de metadados será criado quando o fluxo gravável for fechado.

Exemplos

<?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));

A saída seria então semelhante a:

string(6) "foobar"

Veja também

• MongoDB\GridFS\Bucket::uploadFromStream()