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

新しく作成された GridFS ファイルに関連付けられたメタデータ ドキュメントの_idフィールド。 _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()