Docs Menu
Docs Home
/ / /
PHP ライブラリ マニュアル
/ /

MongoDB\GridFS\Bbucket::uploadFromStream()

項目一覧

  • 定義
  • パラメーター
  • Return Values
  • エラーと例外
  • その他の参照
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フィールドは設定されません。

新しく作成された 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"
}

戻る

rename()