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

MongoDB\GridFS\Bucket::downloadToStreamByName()

項目一覧

  • 定義
  • パラメーター
  • エラーと例外
  • その他の参照
MongoDB\GridFS\Bucket::downloadToStreamByName()

filenameで GridFS ファイルを選択し、その内容を書き込み可能なストリームにコピーします。

function downloadToStreamByName(
string $filename,
resource $destination,
array $options = []
): void
$filename : string
ダウンロードするファイルのfilename
$destination : resource
GridFS ファイルの内容が書き込まれる書込み可能なストリーム。
$options : 配列

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

名前
タイプ
説明
改訂
integer

検索するファイルのリダイレクト。 同じfilenameを持つファイルは、 uploadDateフィールドによって区別されます。

バージョン番号は、次のように定義されます。

  • 0 = 保存された元のファイル

  • 1 = 最初の改訂版

  • 2 = 2 番目の改訂版

  • etc...

  • -2 = 最新の 2 番目の改訂版

  • -1 = 最新のリビジョニング

デフォルトは -1(最新のリビジョニング)です。

MongoDB\GridFS\Exception\FileNotFoundException 選択基準に一致するファイルが見つからなかった場合は、。

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);
$bucket->uploadFromStream('filename', $stream);
$destination = fopen('php://temp', 'w+b');
$bucket->downloadToStreamByName('filename', $destination);
var_dump(stream_get_contents($destination, -1, 0));

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

string(6) "foobar"

戻る

ダウンロードToStream()