MongoDB\GridFS\Bbucket::uploadFromStream()

定義

MongoDB\GridFS\Bucket::uploadFromStream()

新しい GridFS ファイルを作成し、読み取り可能なストリームの内容をそのファイルにコピーします。

function uploadFromStream(
    string $filename,
    resource $source,
    array $options = []
): mixed

パラメーター

$filename : string

作成するファイルのfilename 。

$source : resource

新しい GridFS ファイルの内容が読み取られる読み取り可能なストリーム。

$options : 配列

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

名前	タイプ	説明
_id	混合	ファイルドキュメント識別子として使用する値。デフォルトでは、新しい MongoDB\ BSON\ObjectId オブジェクトになります。
chunkSizeBytes	integer	バイト単位での チャンク サイズ 。 デフォルトはバケットのchunkSizeBytesオプションです。
disableMD5	ブール値	ファイルを保存するときに MD5 の自動生成を無効にするかどうか。 デフォルトはfalseです。 2.0ではtrueのみがサポートされます。 バージョン 1.4 で追加。
metadata	array|object	ファイル ドキュメントのmetadataフィールドのユーザー データ。 指定しない場合、ファイル ドキュメントのmetadataフィールドは設定されません。

Return Values

_id新しく作成されたGridFSファイルに関連付けられたメタデータドキュメントの フィールド。_id オプションが指定されていない場合は、新しいMongoDB\ BSON\ObjectIdオブジェクトがデフォルトで 使用されます。

エラーと例外

MongoDB\Exception\InvalidArgumentException は、パラメータまたはオプションの解析に関連するエラーの場合は です。

拡張レベルのその他のエラー（例: 接続エラー）の場合は、 MongoDB\Driver\Exception\RuntimeException 。

例

<?php
$bucket = (new MongoDB\Client)->test->selectGridFSBucket();
$stream = fopen('php://temp', 'w+b');
fwrite($stream, "foobar");
rewind($stream);
$id = $bucket->uploadFromStream('filename', $stream);
var_dump($id);

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

object(MongoDB\BSON\ObjectId)#3009 (1) {
  ["oid"]=>
  string(24) "5acf81017e21e816e538d883"
}

その他の参照

• MongoDB\GridFS\Bucket::openUploadStream()