MongoDB\GridFS\Bucket::openUploadStream()

定義

MongoDB\GridFS\Bucket::openUploadStream()

新しい GridFS ファイルの書込み可能なストリームを開きます。

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

パラメーター

$filename : string

作成するファイルのfilename 。

$options : 配列

必要なオプションを指定する配列。

名前	タイプ	説明
_id	混合	ファイルドキュメント識別子として使用する値。デフォルトでは、新しいMongoDB\BSON\ObjectIdオブジェクトになります。
chunkSizeBytes	integer	バイト単位での チャンク サイズ 。 デフォルトはバケットのchunkSizeBytesオプションです。
metadata	array|object	ファイル ドキュメントのmetadataフィールドのユーザー データ。 指定しない場合、ファイル ドキュメントのmetadataフィールドは設定されません。

Return Values

書込み可能なストリーム リソース。

動作

チャンク ドキュメントは、データが書込み可能なストリームに書き込まれるにつれて作成されます。 メタデータ ドキュメントは、書込み可能なストリームが閉じられたときに作成されます。

例

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

出力は次のようになります。

string(6) "foobar"

その他の参照

• MongoDB\GridFS\Bucket::uploadFromStream()