MongoGridFS::findOne

条件にマッチする単一のファイルを返す

説明

public MongoGridFSFile MongoGridFS::findOne ([ mixed $query = array() [, mixed $fields = array() ]] )

パラメータ

query: 探したいファイル名あるいは条件。

返り値

MongoGridFSFile、あるいは null を返します。

例

例1 MongoGridFS::findOne の例

この例は、MongoGridFS からファイルを検索する方法を示します。


<?php

$downloads = $mongo->my_db->getGridFS('downloads');

$downloads->storeFile('filename.tgz');

$download = $downloads->findOne('filename.tgz'); // MongoGridFSFile のインスタンス

print_r($download);
?>

ファイルの挙動についての詳細な情報は MongoGridFSFile を参照ください。

上の例の出力は、たとえば以下のようになります。

MongoGridFSFile Object
(
    [file] => Array
        (
            [_id] => MongoId Object
                (
                )

            [filename] => filename.tgz
            [uploadDate] => MongoDate Object
                (
                    [sec] => 1274288014
                    [usec] => 467000
                )

            [chunkSize] => 262144
            [md5] => d41d8cd98f00b204e9800998ecf8427e
        )

    [gridfs:protected] => MongoGridFS Object
        (
            [chunks] => MongoCollection Object
                (
                )

            [filesName:protected] => downloads.files
            [chunksName:protected] => downloads.chunks
        )

)